Arbeta med AZURE Developer CLI-miljöer

Azure Developer CLI (azd) hjälper dig att skapa och hantera miljöer med sina egna konfigurationer, till exempel utveckling, testning och prod. Den här artikeln visar hur du skapar och hanterar miljöer och hur du använder dem med dina Bicep-infrastrukturfiler.

Skapa miljöer

Skapa en ny miljö med kommandot azd env new :

azd env new <environment-name>

Om du till exempel vill skapa en utvecklingsmiljö:

azd env new dev

När du kör ett kommando som azd up eller azd deployuppmanas azd du att välja en Azure-prenumeration och plats för den nya miljön. Prompt-inställningar lagras i den nya miljön .env eller config.json filerna.

Du kan också ange prenumeration och plats direkt i kommandot:

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

Lista miljöer

Om du vill se alla tillgängliga miljöer för projektet använder du:

azd env list

Det här kommandot visar alla miljöer som du har skapat och markerar den aktuella aktiva miljön:

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

Växla mellan miljöer

Om du vill växla till en annan miljö använder du azd env select kommandot:

azd env select <environment-name>

Om du till exempel vill växla till en produktionsmiljö:

azd env select prod

Förstå standardmiljön

Den globala konfigurationsfilen .azure/config.json håller reda på din aktuella miljö. När du kör azd init och det inte finns några miljöer ännu skapar azd du automatiskt din första miljö och anger den som standard. Om du redan har en eller flera miljöer och kör azd env new <name>uppmanas azd du att välja om den nya miljön ska vara standard. Om du avböjer skapas den nya miljön, men det aktuella valet förblir oförändrat.

Du kan tillfälligt åsidosätta standardmiljön för ett enda kommando med hjälp --environment av flaggan. Om du använder den här flaggan ändras inte standardvärdet för framtida kommandon.

Uppdatera miljöinställningar

Du kan uppdatera dina lokala miljövariabler med hjälp av azd env refresh kommandot . Det här kommandot letar upp den senaste Azure-distributionen för din app, hämtar miljövariabelvärdena efter namn och uppdaterar sedan din lokala .env fil med de senaste värdena för den valda miljön. Om du till exempel har etablerat både en dev version och prod har dev valt miljön hämtar den senaste utdata från distributionen för att fylla i .env-filen.

azd env refresh

Det är användbart att uppdatera din miljö när:

• Du vill se till att den lokala .env filen återspeglar de senaste utdata från infrastrukturen (t.ex. anslutningssträngar, slutpunkter osv.).
• Du måste synkronisera miljövariabler när en lagkamrat har uppdaterat miljön.

Om andra teammedlemmar har gjort ändringar i miljökonfigurationer, eller om du har gjort ändringar via Azure-portalen, kan du uppdatera dina lokala miljöinställningar med:

Köra kommandon i specifika miljöer

Du kan köra många azd kommandon i en specifik miljö utan att ändra din aktiva miljö med hjälp --environment av flaggan eller -e :

azd up --environment dev

Det här kommandot kör up arbetsflödet (etablera och distribuera) i dev miljön utan att ändra din aktiva miljö.

Du kan också först växla till din avsedda miljö:

azd env select test
azd up

Ta bort miljöresurser

Om du vill ta bort Azure-resurserna för en specifik miljö använder du azd down kommandot :

azd down <environment-name>

Använda miljönamnet i infrastrukturfiler

Du kan använda variabeln AZURE_ENV_NAME från miljöns .env fil för att anpassa infrastrukturdistributionerna i Bicep. Detta är användbart för att namnge, tagga eller konfigurera resurser baserat på den aktuella miljön.

1. azd AZURE_ENV_NAME anger miljövariabeln när du initierar ett projekt.

   AZURE_ENV_NAME=dev
   

2. main.parameters.json I filen refererar du till miljövariabeln så azd att dess värde ersätts:

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

   När du distribuerar med azdskickas värdet från .env till Bicep-filen från main.parameters.json.

3. I Bicep-mallen definierar du en parameter för miljönamnet:

   param environmentName string
   

4. Du kan använda parametern environmentName för att tagga resurser, vilket gör det enkelt att identifiera vilken miljö en resurs tillhör:

   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'
     }
   }
   

Den här metoden hjälper till med resurshantering, kostnadsspårning och automatisering genom att associera varje resurs med dess distributionsmiljö.

Nästa steg