Omówienie środowisk interfejsu wiersza polecenia dla deweloperów platformy Azure

Interfejs wiersza polecenia dla deweloperów platformy Azure (azd) umożliwia zarządzanie wieloma środowiskami wdrażania dla projektów, aby zachować oddzielne konfiguracje na potrzeby programowania, testowania i produkcji. W tym artykule wyjaśniono podstawowe pojęcia dotyczące sposobu używania środowisk do zarządzania procesem programowania i wdrażania.

Co to są środowiska?

Środowisko w interfejsie wiersza polecenia dla deweloperów platformy Azure (azd) to nazwany zestaw konfiguracji dla wdrożenia aplikacji, taki jak tworzenie, testowanie lub prod. Różne środowiska można skonfigurować przy użyciu różnych wartości. Środowiska służą kilku ważnym celom:

• Izolacja: zachowaj oddzielne wdrożenia programistyczne, testowe i produkcyjne.
• Zarządzanie konfiguracją: obsługa różnych ustawień dla każdego środowiska.
• Współpraca: umożliwia członkom zespołu pracę z własnymi środowiskami.
• Organizacja zasobów: grupowanie i aprowizuj zasoby platformy Azure według środowiska.
• Powtarzalność: zapewnij spójne wdrożenia na różnych etapach.

Każde środowisko ma własną grupę zasobów platformy Azure i ustawienia konfiguracji. Ta izolacja środowiska pomaga zapobiegać zmianom w jednym środowisku wpływającym na inne.

Struktura i konfiguracja środowiska

Środowiska interfejsu wiersza polecenia dla deweloperów platformy Azure (azd) działają w strukturze katalogów w projekcie:

├── .azure                          [Created when you run azd init or azd up]
│   ├── <environment-name-1>        [Directory for environment-specific configurations]
│   │   ├── .env                    [Environment variables for this environment]
│   │   └── config.json             [Additional configuration parameters for this environment]
│   ├── <environment-name-2>        [Another environment]
│   │   ├── .env                    
│   │   └── config.json
│   └── config.json                 [Global azd configuration]

Kluczowe składniki tej struktury to:

• .azure directory: katalog główny dla wszystkich konfiguracji środowiska. Domyślnie wykluczone z kontroli źródła przez .gitignore plik.
• Katalogi specyficzne dla środowiska: katalogi nazwane po środowiskach, takie jak dev, test, . prod
• .env plik: zawiera zmienne specyficzne dla środowiska używane przez aplikację i podczas wdrażania.
• config.json: służy do określania ustawień mających wpływ na azd zachowanie poleceń i funkcje. Ten plik nie jest przeznaczony do bezpośredniego użycia przez użytkowników końcowych.

Nazwy środowisk

Nazewnictwo środowiska zwykle jest zgodne z następującymi wzorcami:

• Projekty zespołowe: <project-name-[dev/int/prod]>
• Projekty osobiste: <personal-unique-alias-[dev/int/prod]>

Te konwencje nazewnictwa nie są wymuszane przez azd użytkownika i można je konfigurować.

Zmienne środowiskowe

Zmienne środowiskowe interfejsu wiersza polecenia dla deweloperów platformy Azure umożliwiają przechowywanie ustawień konfiguracji, które mają wpływ i mogą się różnić między środowiskami. Po uruchomieniu poleceń interfejsu wiersza polecenia dla deweloperów platformy Azure następujące zmienne są używane do:

• Skonfiguruj ustawienia aplikacji, takie jak punkty końcowe dla usług platformy Azure.
• Zdefiniuj parametry infrastruktury, aby wpłynąć na proces aprowizacji.

Plik .env zawiera te zmienne w standardowym formacie:

AZURE_ENV_NAME=dev
AZURE_LOCATION=eastus
AZURE_SUBSCRIPTION_ID=00000000-0000-0000-0000-000000000000
AZURE_RESOURCE_GROUP=rg-dev-12345
SERVICE_WEB_HOSTNAME=web-dev-12345.azurewebsites.net
SERVICE_API_HOSTNAME=api-dev-12345.azurewebsites.net

Typowe zmienne środowiskowe obejmują:

Podczas pracy ze zmiennymi środowiskowymi:

• Unikaj zatwierdzania .env plików do kontroli źródła. Jeśli konfiguracja środowiska musi być utrwalone lub współużytkowana, użytkownicy powinni używać środowisk zdalnych.
• Używaj spójnego nazewnictwa w różnych środowiskach.
• azd env set Użyj polecenia , aby bezpiecznie zaktualizować zmienne.

Porównanie innych środowisk platformowych

Wiele platform programowania i narzędzi, takich jak Node.js, Django lub React, używa .env plików do konfiguracji. Chociaż interfejs wiersza polecenia dla deweloperów platformy Azure (azd) używa .env również plików, istnieją ważne różnice:

Chociaż oba te rozwiązania służą podobnym celom, podejście interfejsu wiersza polecenia .env dla deweloperów platformy Azure dodaje strukturę i narzędzia przeznaczone do zarządzania wieloma środowiskami wdrażania i zasobami platformy Azure.

Dalsze kroki