Přehled prostředí Azure Developer CLI

Azure Developer CLI (azd) umožňuje spravovat více prostředí nasazení pro vaše projekty, aby byly konfigurace oddělené pro vývoj, testování a produkci. Tento článek vysvětluje základní koncepty, jak můžete používat prostředí ke správě procesu vývoje a nasazení.

Co jsou prostředí?

Prostředí v Azure Developer CLI (azd) je pojmenovaná sada konfigurací pro nasazení vaší aplikace, jako je vývoj, testování nebo prod. Různá prostředí je možné nakonfigurovat s různými hodnotami. Prostředí slouží k několika důležitým účelům:

  • Izolace: Udržujte vývoj, testování a produkční nasazení oddělená.
  • Správa konfigurace: Pro každé prostředí udržujte různá nastavení.
  • Spolupráce: Umožňuje členům týmu pracovat se svými vlastními prostředími.
  • Organizace prostředků: Seskupte a zřiďte prostředky Azure podle prostředí.
  • Reprodukovatelnost: Zajistěte konzistentní nasazení v různých fázích.

Každé prostředí má vlastní skupinu prostředků Azure a nastavení konfigurace. Tato izolace prostředí pomáhá zabránit změnám v jednom prostředí, aby ovlivnila ostatní.

Struktura a konfigurace prostředí

Prostředí Azure Developer CLI (azd) jsou v adresářové struktuře v rámci vašeho projektu:

├── .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]

Klíčové komponenty této struktury jsou:

  • .azure adresář: Kořenový adresář pro všechny konfigurace prostředí. Ve výchozím nastavení je soubor vyloučený ze správy zdrojového .gitignore kódu.
  • Adresáře specifické pro prostředí: Adresáře pojmenované za vašimi prostředími, například dev, test. prod
  • .env soubor: Obsahuje proměnné specifické pro prostředí používané vaší aplikací a během nasazování.
  • config.json: Slouží k řízení nastavení, která ovlivňují azd chování příkazů a funkce. Tento soubor není určený přímo koncovými uživateli.

Názvy prostředí

Pojmenování prostředí se obvykle řídí těmito vzory:

  • Týmové projekty: <project-name-[dev/int/prod]>
  • Osobní projekty: <personal-unique-alias-[dev/int/prod]>

Tyto zásady vytváření názvů se nevynucují azd a jsou konfigurovatelné uživatelem.

Proměnné prostředí

Proměnné prostředí Azure Developer CLI poskytují způsob ukládání nastavení konfigurace, které ovlivňují a můžou se mezi prostředími lišit. Při spouštění příkazů Azure Developer CLI se tyto proměnné používají k těmto proměnným:

  • Nakonfigurujte nastavení aplikace, jako jsou koncové body pro služby Azure.
  • Definujte parametry infrastruktury, které ovlivňují proces zřizování.

Soubor .env obsahuje tyto proměnné ve standardním formátu:

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

Mezi běžné proměnné prostředí patří:

Proměnná Popis
AZURE_ENV_NAME Název aktuálního prostředí
AZURE_LOCATION Oblast Azure, ve které se nasazují prostředky
AZURE_SUBSCRIPTION_ID ID předplatného Azure použitého pro toto prostředí
AZURE_RESOURCE_GROUP Název skupiny prostředků pro toto prostředí

Tip

Další běžné proměnné prostředí a příklady specifické pro službu najdete v dokumentaci k proměnným prostředí .

Při práci s proměnnými prostředí:

  • Vyhněte se potvrzení .env souborů do správy zdrojového kódu. Pokud je potřeba zachovat nebo sdílet konfiguraci prostředí, uživatelé by měli používat vzdálená prostředí.
  • Používejte konzistentní pojmenování napříč prostředími.
  • azd env set Pomocí příkazu můžete bezpečně aktualizovat proměnné.

Výstraha

Nikdy neukládejte tajné kódy do souboru Azure Developer CLI .env . Tyto soubory je možné snadno sdílet nebo kopírovat do neautorizovaných umístění nebo se vrátit se změnami do správy zdrojového kódu. Pro chráněná nebo bez tajných kódů používejte služby, jako je Azure Key Vault nebo Řízení přístupu na základě role (RBAC).

Porovnání dalších prostředí architektury

Mnoho programovacích architektur a nástrojů, jako jsou Node.js, Django nebo React, používají .env soubory pro konfiguraci. I když Azure Developer CLI (azd) také používá .env soubory, existují důležité rozdíly:

Koncepce Azure Developer CLI .env Soubory architektury .env
Umístění Uloženo v .azure/<environment-name>/.env Obvykle uložené v kořenovém adresáři projektu
Podpora prostředí Podpora více uživatelsky definovaných prostředí (vývoj, testování, prod) Často vyžadují ruční přepínání souborů nebo zásady vytváření názvů (.env.development, .env.production)
Mechanismus načítání Automaticky načtené příkazy azd Obvykle vyžadují explicitní načtení v kódu aplikace nebo skriptech sestavení.
Integrace Hluboce integrovaná se službami Azure a zřizováním prostředků Konfigurace pro obecné účely, ne specifická pro Azure
Správa proměnných Spravováno pomocí azd env příkazů Obvykle se upravují ručně nebo prostřednictvím vlastních skriptů.

I když oba slouží podobným účelům, přístup Azure Developer CLI .env přidává strukturu a nástroje navržené pro správu více prostředí nasazení a prostředků Azure.

Poznámka:

Pokud váš projekt už používá soubory specifické pro .env architekturu, můžete zachovat oba konfigurační systémy bez konfliktů. azd Proměnné prostředí přepisují systémové proměnné prostředí se stejným názvem pro některé operace.

Další kroky

Práce s prostředími

Správa proměnných prostředí v Azure Developer CLI

  • Last updated on