Udostępnij przez

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ą:

Zmienna Opis
AZURE_ENV_NAME Nazwa bieżącego środowiska
AZURE_LOCATION Region świadczenia usługi Azure, w którym wdrażane są zasoby
AZURE_SUBSCRIPTION_ID Identyfikator subskrypcji platformy Azure używanej dla tego środowiska
AZURE_RESOURCE_GROUP Nazwa grupy zasobów dla tego środowiska

Wskazówka

Inne typowe zmienne środowiskowe i przykłady specyficzne dla usługi można znaleźć w dokumentacji Zmiennych środowiskowych .

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.

Ostrzeżenie

Nigdy nie przechowuj wpisów tajnych w pliku interfejsu wiersza polecenia .env dla deweloperów platformy Azure. Te pliki można łatwo udostępnić lub skopiować do nieautoryzowanych lokalizacji lub zaewidencjonować w kontroli źródła. Używaj usług, takich jak Azure Key Vault lub Azure Role Based Access Control (RBAC) dla rozwiązań chronionych lub bez tajemnicy.

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:

Pojęcie Interfejs wiersza polecenia dla deweloperów platformy Azure .env Pliki struktury .env
Lokalizacja Przechowywane w .azure/<environment-name>/.env Zazwyczaj przechowywane w katalogu głównym projektu
Obsługa środowiska Obsługa wielu środowisk zdefiniowanych przez użytkownika (tworzenie, testowanie, prod) Często wymagają ręcznego przełączania plików lub konwencji nazewnictwa (.env.development, .env.production)
Mechanizm ładowania Automatycznie ładowane przez azd polecenia Zwykle wymagaj jawnego ładowania w kodzie aplikacji lub skryptach kompilacji
Integracja Głęboko zintegrowana z usługami platformy Azure i aprowizowaniem zasobów Konfiguracja ogólnego przeznaczenia, a nie specyficzna dla platformy Azure
Zarządzanie zmiennymi Zarządzane za pomocą azd env poleceń Zazwyczaj edytowane ręcznie lub za pomocą skryptów niestandardowych

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.

Uwaga / Notatka

Jeśli projekt używa już plików specyficznych dla .env platformy, możesz zachować oba systemy konfiguracji bez konfliktów. azd zmienne środowiskowe zastępują zmienne środowiskowe systemu o tej samej nazwie dla niektórych operacji.

Dalsze kroki

Praca ze środowiskami

Zarządzanie zmiennymi środowiskowymi w interfejsie wiersza polecenia dla deweloperów platformy Azure

  • Last updated on