Správa proměnných prostředí

Proměnné prostředí je možné nakonfigurovat tak, aby ovlivnily zřizování a nasazení prostředků do Azure. To je zvlášť užitečné při spouštění AZD ve scénářích pracovních postupů CI/CD.

Nahrazení vstupních parametrů

Proměnné prostředí lze odkazovat v souborech parametrů (*.parameters.json pro Bicep, *.tfvars.json pro Terraform) v rámci zřizování. Pokud je zjištěna syntaxe nahrazení proměnné prostředí, azd automaticky nahradí odkaz skutečnou sadou hodnot proměnné prostředí. K nahrazení dochází také u určitých nastavení konfigurace v azure.yaml (vlastnosti zdokumentované s nahrazováním proměnných prostředí) a v konfiguračních souborech nasazení, jako jsou manifesty nasazení pro aks.

Příklad: Nahrazení vstupního parametru (Bicep)

Předpokládejme, že máte sadu proměnných AZURE_LOCATION prostředí:

export AZURE_LOCATION=westus3

$env:AZURE_LOCATION='westus3'

main.parameters.json V souboru můžete odkazovat AZURE_LOCATION a povolit nahrazení prostředí pomocí následující syntaxe:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "location": {
      "value": "${AZURE_LOCATION}"
    }
  }
}

Soubor specifický pro .env prostředí

Výstupy pro zřizování infrastruktury se automaticky ukládají jako proměnné prostředí v souboru umístěném .env v části .azure/<environment name>/.env. Toto nastavení umožňuje místní aplikaci nebo skripty nasazení používat proměnné uložené v .env souboru k odkazování na prostředky hostované v Azure v případě potřeby. Pokud chcete zobrazit tyto výstupy, spusťte azd env get-valuesnebo azd env get-values --output json pro výstup JSON.

Proměnné prostředí poskytované službou azd

Následují proměnné, které jsou automaticky poskytovány azd:

Název	Popis	Příklady	Pokud je k dispozici
AZURE_ENV_NAME	Název používaného prostředí.	todo-app-dev	Při vytvoření prostředí (například po spuštění příkazu azd init nebo azd env new).
AZURE_LOCATION	Umístění používaného prostředí.	eastus2	Těsně před prvním zřízením prostředí.
AZURE_PRINCIPAL_ID	Spuštěný uživatel nebo instanční objekt.	925cff12-ffff-4e9f-9580-8c06239dcaa4	Určuje se automaticky během zřizování (dočasný).
AZURE_SUBSCRIPTION_ID	Cílové předplatné.	925cff12-ffff-4e9f-9580-8c06239dcaa4	Těsně před prvním zřízením prostředí.
SERVICE_<service>_IMAGE_NAME	Úplný název image kontejneru publikované ve službě Azure Container Registry pro služby container App Services.	todoapp/web-dev:azdev-deploy-1664988805	Po úspěšném publikování containerapp image

Proměnné prostředí poskytnuté uživatelem

Uživatelem poskytnuté proměnné lze deklarovat jako výstupní parametr infrastruktury (který se automaticky ukládá .env) nebo nastavit přímo uživatelem v prostředí (azd env set <key> <value>). azd čte hodnoty jako konfigurace a provádí odlišně.

Název	Popis	Příklady	Účinek
AZURE_AKS_CLUSTER_NAME	Název clusteru Azure Kubernetes Service, který se má cílit.	aks-my-cluster	Požadovaná vlastnost pro nasazení aks služby
AZURE_RESOURCE_GROUP	Konkrétní skupina prostředků, která se má cílit. Zadejte řetězec.	rg-todo-dev	azd nebude provádět zjišťování skupin prostředků a místo toho odkazuje na tuto skupinu prostředků. azd také neřídí vytvořené konfigurační soubory IaC, takže změny souborů IaC mohou být potřeba.
AZURE_CONTAINER_REGISTRY_ENDPOINT	Koncový bod služby Azure Container Registry pro publikování image Dockeru Zadejte řetězec.	myexampleacr.azurecr.io	Požadovaná vlastnost pro nasazení containerapp služby nebo aks služby.
SERVICE_<service>_ENDPOINTS	Koncové body pro konkrétní službu. Typ array (bicep) / list-equivalent (terraform).	['endpoint1', 'endpoint2']	Nastaví veřejné koncové body pro konkrétní službu, které bude používat azd k zobrazení. Ve výchozím nastavení azd zjistí automaticky přiřazené názvy hostitelů pro daného hostitele, například *.azurewebsites.net pro appservice.

Povolení demo režimu

azd obsahuje ukázkový režim, který skryje ID vašeho předplatného ve výstupu konzoly. Tato funkce je užitečná pro scénáře, ve kterých chcete ukázkovat nebo prezentovat azd příkazy ve veřejném nastavení.

Ukázkový režim zavádí proměnnou prostředí: AZD_DEMO_MODE. Pokud chcete povolit ukázkový režim, spusťte:

export AZD_DEMO_MODE true

Pokud chcete, aby se ukázkový režim zachoval napříč restartováními, můžete také spustit:

setx AZD_DEMO_MODE true

nebo v PowerShellu:

$env:AZD_DEMO_MODE="true"