Praca ze środowiskami interfejsu wiersza polecenia dla deweloperów platformy Azure

Interfejs wiersza polecenia dla deweloperów platformy Azure (azd) ułatwia tworzenie środowisk i zarządzanie nimi przy użyciu własnych konfiguracji, takich jak tworzenie, testowanie i testowanie. W tym artykule pokazano, jak tworzyć środowiska i zarządzać nimi oraz jak używać ich z plikami infrastruktury Bicep.

Tworzenie środowisk

Utwórz nowe środowisko przy użyciu azd env new polecenia :

azd env new <environment-name>

Aby na przykład utworzyć środowisko deweloperskie:

azd env new dev

Po uruchomieniu polecenia, takiego jak azd up lub azd deploy, azd zostanie wyświetlony monit o wybranie subskrypcji i lokalizacji platformy Azure dla nowego środowiska. Ustawienia monitu są przechowywane w nowym środowisku .env lub config.json plikach.

Możesz również określić subskrypcję i lokalizację bezpośrednio w poleceniu:

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

Lista środowisk

Aby wyświetlić wszystkie dostępne środowiska dla projektu, użyj:

azd env list

To polecenie wyświetla wszystkie utworzone środowiska z wyróżnionym bieżącym aktywnym środowiskiem:

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

Przełączanie między środowiskami

Aby przełączyć się do innego środowiska, użyj azd env select polecenia :

azd env select <environment-name>

Aby na przykład przełączyć się do środowiska produkcyjnego:

azd env select prod

Omówienie środowiska domyślnego

Plik .azure/config.json konfiguracji globalnej śledzi aktualnie wybrane środowisko. Po uruchomieniu azd init i nie istnieją jeszcze żadne środowiska, azd automatycznie tworzy pierwsze środowisko i ustawia je jako domyślne. Jeśli masz już jedno lub więcej środowisk i uruchomisz azd env new <name>polecenie , azd wyświetli monit o wybranie, czy nowe środowisko ma być domyślne. Jeśli odrzucisz, nowe środowisko zostanie utworzone, ale bieżące zaznaczenie pozostanie niezmienione.

Możesz tymczasowo zastąpić domyślne środowisko dla pojedynczego polecenia przy użyciu flagi --environment . Użycie tej flagi nie zmienia wartości domyślnej dla przyszłych poleceń.

Odświeżanie ustawień środowiska

Lokalne zmienne środowiskowe można odświeżyć za pomocą azd env refresh polecenia . To polecenie lokalizuje najnowsze wdrożenie platformy Azure dla aplikacji, pobiera wartości zmiennych środowiskowych według nazwy, a następnie aktualizuje plik lokalny .env przy użyciu tych najnowszych wartości dla wybranego środowiska. Jeśli na przykład zainicjowano obsługę administracyjną dev elementu i prod wersję, a obecnie dev wybrano środowisko, pobiera on najnowsze dane wyjściowe z tego wdrożenia, aby wypełnić plik env.

azd env refresh

Odświeżanie środowiska jest przydatne w następujących przypadkach:

• Chcesz mieć pewność, że plik lokalny .env odzwierciedla najnowsze dane wyjściowe z infrastruktury (takie jak parametry połączenia, punkty końcowe itp.).
• Należy zsynchronizować zmienne środowiskowe po zaktualizowaniu środowiska przez kolegę z zespołu.

Jeśli inni członkowie zespołu wprowadzili zmiany w konfiguracjach środowiska lub jeśli wprowadziliśmy zmiany w witrynie Azure Portal, możesz odświeżyć ustawienia środowiska lokalnego za pomocą polecenia:

Uruchamianie poleceń w określonych środowiskach

Możesz uruchomić wiele azd poleceń w określonym środowisku bez zmieniania aktywnego środowiska przy użyciu flagi --environment lub -e :

azd up --environment dev

To polecenie uruchamia up przepływ pracy (aprowizację i wdrażanie) w dev środowisku bez zmieniania aktywnego środowiska.

Alternatywnie możesz najpierw przełączyć się do zamierzonego środowiska:

azd env select test
azd up

Usuwanie zasobów środowiska

Aby usunąć zasoby platformy Azure dla określonego środowiska, użyj azd down polecenia :

azd down <environment-name>

Używanie nazwy środowiska w plikach infrastruktury

Możesz użyć zmiennej AZURE_ENV_NAME.env z pliku środowiska, aby dostosować wdrożenia infrastruktury w aplikacji Bicep. Jest to przydatne w przypadku nazewnictwa, tagowania lub konfigurowania zasobów na podstawie bieżącego środowiska.

1. azd ustawia zmienną AZURE_ENV_NAME środowiskową podczas inicjowania projektu.

   AZURE_ENV_NAME=dev
   

2. W pliku main.parameters.json należy odwołać się do zmiennej środowiskowej, aby azd zastąpić jej wartość:

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

   Podczas wdrażania za pomocą azdpolecenia wartość z .env jest przekazywana do pliku Bicep z .main.parameters.json

3. W szablonie Bicep zdefiniuj parametr dla nazwy środowiska:

   param environmentName string
   

4. Parametru environmentName można użyć do tagowania zasobów, co ułatwia zidentyfikowanie środowiska, do którego należy zasób:

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

Takie podejście pomaga w zarządzaniu zasobami, śledzeniu kosztów i automatyzacji przez skojarzenie każdego zasobu ze środowiskiem wdrażania.

Dalsze kroki