Sdílet prostřednictvím

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

  • Článek

Proměnné prostředí ovlivňují způsob 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) v main.bicep souboru nebo je 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"