Azure Developer CLI-környezetek használata

Az Azure Developer CLI (azd) segítségével saját konfigurációkkal hozhat létre és kezelhet környezeteket , például fejlesztéssel, teszteléssel és fejlesztéssel. Ez a cikk bemutatja, hogyan hozhat létre és kezelhet környezeteket, és hogyan használhatja őket a Bicep-infrastruktúrafájljaival.

Környezetek létrehozása

Hozzon létre egy új környezetet a azd env new következő paranccsal:

azd env new <environment-name>

Például fejlesztési környezet létrehozása:

azd env new dev

Amikor egy olyan parancsot futtat, mint a azd up vagy azd deploy, azd megkéri, hogy válasszon ki egy Azure-előfizetést és helyet az új környezethez. A parancssori beállítások az új környezetben .env vagy config.json fájlokban vannak tárolva.

Az előfizetést és a helyet közvetlenül a parancsban is megadhatja:

azd env new prod --subscription "My Production Subscription" --location eastus2

Környezetek listája

A projekt összes elérhető környezetének megtekintéséhez használja a következőt:

azd env list

Ez a parancs megjeleníti az összes létrehozott környezetet, kiemelve az aktuális aktív környezetet:

NAME      DEFAULT   LOCAL     REMOTE
dev       true      true      false
test      false     true      false
prod      false     true      false

Váltás környezetek között

Ha másik környezetre szeretne váltani, használja a azd env select következő parancsot:

azd env select <environment-name>

Ha például éles környezetre szeretne váltani:

azd env select prod

Megjegyzés:

Ez a parancs módosítja az aktív környezetet, ami hatással van a következő azd parancsra, például provision vagy deploy.

Az alapértelmezett környezet ismertetése

A globális konfigurációs fájl .azure/config.json nyomon követi a jelenleg kijelölt környezetet. Amikor fut azd init , és még nem létezik környezet, automatikusan létrehozza az első környezetet, azd és alapértelmezettként állítja be. Ha már rendelkezik egy vagy több környezettel, és fut, azd env new <name>megkéri, azd hogy adja meg, hogy az új környezet legyen-e az alapértelmezett. Ha elutasítja, az új környezet létrejön, de az aktuális kijelölés változatlan marad.

A jelölő használatával ideiglenesen felülbírálhatja egyetlen parancs alapértelmezett környezetét --environment . A jelölő használata nem változtatja meg a jövőbeli parancsok alapértelmezett értékét.

Környezeti beállítások frissítése

A helyi környezeti változókat a azd env refresh parancs használatával frissítheti. Ez a parancs megkeresi az alkalmazás legújabb Azure-üzembe helyezését, név szerint lekéri a környezeti változó értékeit, majd frissíti a helyi .env fájlt a kiválasztott környezet legújabb értékeivel. Ha például kiépített egy és prod egy dev verziót is, és jelenleg a dev környezet van kiválasztva, az az .env fájl feltöltéséhez lekéri az adott üzembe helyezés legújabb kimenetét.

azd env refresh

Megjegyzés:

A azd env refresh parancs nem helyezi újra üzembe az erőforrásokat. Csak úgy frissíti a helyi környezet konfigurációját, hogy megfeleljen az Azure jelenlegi állapotának.

A környezet frissítése akkor hasznos, ha:

• Biztosítani szeretné, hogy a helyi .env fájl tükrözze az infrastruktúra legújabb kimeneteit (például kapcsolati sztringeket, végpontokat stb.).
• Miután egy csapattag frissítette a környezetet, szinkronizálnia kell a környezeti változókat.

Ha más csapattagok módosították a környezeti konfigurációkat, vagy ha az Azure Portalon végzett módosításokat, a következőkkel frissítheti a helyi környezeti beállításokat:

Parancsok futtatása adott környezetekben

Egy adott környezetben számos azd parancsot futtathat anélkül, hogy módosítaná az aktív környezetet a --environment következő jelölő vagy -e jelölő használatával:

azd up --environment dev

Ez a parancs az aktív környezet módosítása nélkül futtatja a up munkafolyamatot (üzembe helyezés és üzembe helyezés) a dev környezetben.

Másik lehetőségként válthat a kívánt környezetre:

azd env select test
azd up

Megjegyzés:

A Teamsnek érdemes megfontolnia a CICD-folyamatok parancson keresztüli azd pipeline config használatát, nem pedig az olyan parancsokat használó közvetlen üzembe helyezéseket, mint például azd up a vagy azd provision.

Környezeti erőforrások törlése

Egy adott környezet Azure-erőforrásainak törléséhez használja a azd down következő parancsot:

azd down <environment-name>

Megjegyzés:

Jelenleg nem lehet közvetlenül parancsokkal törölni vagy átnevezni azd a környezeteket. Ha át kell neveznie egy környezetet:

• A környezeti erőforrások törlésére használható azd down .
• Futtassa azd env new <new-name> az új környezet létrehozását.
• Törölje manuálisan a régi .env mappát a mappából .azure.

A környezet nevének használata az infrastruktúrafájlokban

A környezet fájljából .env származó változóval AZURE_ENV_NAME testre szabhatja az infrastruktúra-telepítéseket a Bicepben. Ez hasznos az erőforrások elnevezéséhez, címkézéséhez vagy konfigurálásához az aktuális környezet alapján.

Megjegyzés:

Az Azure Developer CLI-projektek konfigurálásához tekintse meg a Környezeti változók használata című témakört.

1. azd egy projekt inicializálásakor beállítja a AZURE_ENV_NAME környezeti változót.

   AZURE_ENV_NAME=dev
   

2. A fájlban main.parameters.json hivatkozzon a környezeti változóra, és cserélje azd le az értékét:

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

   Az üzembe helyezéskor azda rendszer .env átadja az értéket a Bicep-fájlnak main.parameters.json.

3. A Bicep-sablonban adjon meg egy paramétert a környezet nevéhez:

   param environmentName string
   

4. A paraméterrel environmentName címkézheti az erőforrásokat, így könnyen azonosítható, hogy melyik környezethez tartozik egy erőforrás:

   param environmentName string
   
   resource storageAccount 'Microsoft.Storage/storageAccounts@2022-09-01' = {
     name: 'mystorage${uniqueString(resourceGroup().id)}'
     location: resourceGroup().location
     sku: {
       name: 'Standard_LRS'
     }
     kind: 'StorageV2'
     tags: {
       Environment: environmentName
       Project: 'myproject'
     }
   }
   

Ez a megközelítés segít az erőforrás-kezelésben, a költségkövetésben és az automatizálásban azáltal, hogy az egyes erőforrásokat az üzembehelyezési környezethez társítja.

Következő lépések

Környezeti változók kezelése az Azure Developer CLI-ben

Az Azure Developer CLI-munkafolyamatok testreszabása horogokkal