Környezeti változók kezelése

A környezeti változók úgy konfigurálhatók, hogy befolyásolják az erőforrások üzembe helyezését és üzembe helyezését az Azure-ban. Ez különösen akkor hasznos, ha CI/CD-munkafolyamatokban futtatja az azd-t.

Bemeneti paraméterek helyettesítése

A környezeti változók a kiépítés részeként paraméterfájlokban (*.parameters.json a Bicep esetében a *.tfvars.json Terraform esetében) hivatkozhatók. Környezeti változó helyettesítési szintaxisa esetén azd automatikusan lecseréli a hivatkozást a tényleges környezeti változó értékkészletére. A helyettesítés bizonyos konfigurációs beállítások azure.yaml esetében is előfordul a (környezeti változó helyettesítését támogató tulajdonságokkal dokumentált) és az üzembehelyezési konfigurációs fájlokban, például a telepítési jegyzékekben aks.

Példa: Bemeneti paraméter helyettesítése (Bicep)

Tegyük fel, hogy rendelkezik a környezeti változókészlettel AZURE_LOCATION :

export AZURE_LOCATION=westus3

$env:AZURE_LOCATION='westus3'

A fájlban a main.parameters.json következő szintaxissal hivatkozhat AZURE_LOCATION és engedélyezheti a környezet helyettesítését:

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

Környezetspecifikus .env fájl

Az infrastruktúra-kiépítés kimenetei automatikusan környezeti változóként vannak tárolva egy .env fájlban, amely a következő helyen .azure/<environment name>/.envtalálható: . Ez a beállítás lehetővé teszi, hogy egy helyi alkalmazás vagy üzembe helyezési szkriptek a fájlban tárolt változókat használják az .env Azure által üzemeltetett erőforrásokra való hivatkozáshoz, ha szükséges. A kimenetek megtekintéséhez futtassa azd env get-valuesa azd env get-values --output json JSON-kimenetet.

A környezeti változók által biztosított azd

A következő változók automatikusan a azdkövetkezők:

Név	Leírás	Példák	Ha elérhető
AZURE_ENV_NAME	A használatban lévő környezet neve.	todo-app-dev	Környezet létrehozásakor (például azd init vagy azd env new futtatása után).
AZURE_LOCATION	A használatban lévő környezet helye.	eastus2	Közvetlenül a környezet első üzembe helyezése előtt.
AZURE_PRINCIPAL_ID	A futó felhasználó/szolgáltatásnév.	925cff12-ffff-4e9f-9580-8c06239dcaa4	Automatikusan meghatározva a kiépítés során (rövid élettartam).
AZURE_SUBSCRIPTION_ID	A célzott előfizetés.	925cff12-ffff-4e9f-9580-8c06239dcaa4	Közvetlenül a környezet első üzembe helyezése előtt.
SERVICE_<service>_IMAGE_NAME	A tárolóalkalmazás-szolgáltatásokhoz az Azure Container Registryben közzétett tárolórendszerkép teljes neve.	todoapp/web-dev:azdev-deploy-1664988805	Kép sikeres közzététele containerapp után

Felhasználó által megadott környezeti változók

A felhasználó által megadott változók deklarálhatók infrastruktúrakimeneti paraméterként (amelyet a rendszer automatikusan tárol .env), vagy közvetlenül a környezet felhasználója állítja be (azd env set <key> <value>). azd konfigurációként olvassa be az értékeket, és másképpen hajtja végre a műveletet.

Név	Leírás	Példák	Hatások
AZURE_AKS_CLUSTER_NAME	A megcélozandó Azure Kubernetes Service-fürt neve.	aks-my-cluster	A szolgáltatás üzembe helyezéséhez aks szükséges tulajdonság.
AZURE_RESOURCE_GROUP	A megcélzandó erőforráscsoport. Írja be a sztringet.	rg-todo-dev	azd nem hajtja végre az erőforráscsoport-felderítést, hanem erre az erőforráscsoportra hivatkozik. azd emellett nem szabályozza a létrehozott IaC-konfigurációs fájlokat, ezért szükség lehet az IaC-fájlok módosítására.
AZURE_CONTAINER_REGISTRY_ENDPOINT	A Docker-rendszerkép közzétételére szolgáló Azure Container Registry-végpont. Írja be a sztringet.	myexampleacr.azurecr.io	Egy vagy aks több szolgáltatás üzembe helyezéséhez containerapp szükséges tulajdonság.
SERVICE_<service>_ENDPOINTS	Az adott szolgáltatás végpontjai. Típus array (bicep) / list-equivalent (terraform).	['endpoint1', 'endpoint2']	Beállítja az adott szolgáltatás nyilvános végpontjait az azd a megjelenítéshez. Alapértelmezés szerint az azd felderíti egy adott gazdagép automatikusan hozzárendelt gazdagépneveit, például *.azurewebsites.net a következőhöz appservice: .

Bemutató mód engedélyezése

azd olyan bemutató módot tartalmaz, amely elrejti az előfizetés azonosítóját a konzol kimenetében. Ez a funkció olyan helyzetekben hasznos, amikor nyilvános környezetben szeretné lefokolni vagy bemutatni azd a parancsokat.

A bemutató mód a következő környezeti változót mutatja be: AZD_DEMO_MODE. A bemutató mód engedélyezéséhez futtassa a következőt:

export AZD_DEMO_MODE true

Ha azt szeretné, hogy a bemutató mód az újraindítások között is megmaradjon, a következőket is futtathatja:

setx AZD_DEMO_MODE true

vagy a PowerShellben:

$env:AZD_DEMO_MODE="true"