Azure Developer CLI a prostředí nasazení Azure

V tomto článku se dozvíte o Azure Developer CLI (azd) a o tom, jak funguje s prostředími nasazení Azure (ADE) ke zjednodušení procesu zřizování aplikační infrastruktury a nasazení kódu aplikace do nové infrastruktury.

azd je open-source nástroj příkazového řádku, který poskytuje příkazy vhodné pro vývojáře a které odpovídají klíčovým fázím vašeho pracovního postupu. Můžete ho nainstalovat azd místně na počítač nebo ho použít v jiných prostředích.

Pomocí ADE můžete vytvářet prostředí z definice prostředí v katalogu připojeném k vašemu vývojovému centru nebo pomocí modelu rozšiřitelnosti ADE ke spouštění nasazení. Přidáním azdmůžete zjednodušit proces zřizování infrastruktury a nasazení kódu do cloudu.

Jak azd funguje s ADE?

azd funguje s ADE, abyste mohli vytvářet prostředí z místa, kde pracujete.

S ADE a azdmůžou jednotliví vývojáři pracovat s jedinečnou infrastrukturou a kódem, které chtějí nahrát do cloudu, vytvořit prostředí z místní složky. Můžou použít azd ke zřízení prostředí a bezproblémovému nasazení kódu.

Ve velkém měřítku vám používání ADE a azd společně umožňuje vývojářům vytvářet infrastrukturu aplikací a kód. Váš tým může vytvořit více prostředí ADE ze stejné azd kompatibilní definice prostředí a zřizovat kód do cloudu konzistentním způsobem.

Porozumění azd šablonám

Příkazy Azure Developer CLI jsou navržené tak, aby fungovaly se standardizovanými šablonami. Každá šablona je úložiště kódu, které dodržuje specifické konvence souborů a složek. Šablony azd obsahují prostředky potřebné ke zřízení prostředí Azure Deployment Environment. Když spustíte podobný příkaz azd up, nástroj pomocí prostředků šablony provede různé kroky pracovního postupu, jako je zřizování nebo nasazování prostředků do Azure.

Následující diagram znázorňuje typickou strukturu šablony:

├── infra                                        [ Contains infrastructure as code files ]
├── .azdo                                        [ Configures an Azure Pipeline ]
├── .devcontainer                                [ For DevContainer ]
├── .github                                      [ Configures a GitHub workflow ]
├── .vscode                                      [ VS Code workspace configurations ]
├── .azure                                       [ Stores Azure configurations and environment variables ]
├── src                                          [ Contains all of the deployable app source code ]
└── azure.yaml                                   [ Describes the app and type of Azure resources]

Všechny azd šablony zahrnují následující materiály:

  • infra folder - Složka infra se v azd ADE nepoužívá. Obsahuje veškerou infrastrukturu Bicep nebo Terraform jako soubory kódu pro azd šablonu. ADE poskytuje infrastrukturu jako soubory kódu pro azd šablonu. Tyto soubory azd nemusíte do šablony zahrnout.

  • soubor azure.yaml – Konfigurační soubor , který definuje jednu nebo více služeb v projektu a mapuje je na prostředky Azure pro nasazení. Můžete například definovat službu API a webovou front-endovou službu, z nichž každý má atributy, které je mapují na různé prostředky Azure pro nasazení.

  • Složka .azure – Obsahuje základní konfigurace Azure a proměnné prostředí, například umístění pro nasazení prostředků nebo jiné informace o předplatném.

  • složka src – obsahuje veškerý nasaditelný zdrojový kód aplikace. Některé azd šablony poskytují pouze prostředky infrastruktury a adresář src nechte prázdný, abyste mohli přidat vlastní kód aplikace.

Většina azd šablon také volitelně obsahuje jednu nebo více z následujících složek:

  • Složka .devcontainer – Umožňuje nastavit prostředí vývojového kontejneru pro vaši aplikaci. Tento běžný přístup k vývojovému prostředí, který není specifický pro azd .

  • Složka .github – Obsahuje soubory pracovních postupů CI/CD pro GitHub Actions, což je výchozí zprostředkovatel CI/CD pro azd .

  • Složka .azdo – Pokud se rozhodnete použít Azure Pipelines pro CI/CD, definujte konfigurační soubory pracovního postupu v této složce.

azd kompatibilní katalogy

Katalogy prostředí nasazení Azure se skládají z definic prostředí: šablony IaC definující prostředky infrastruktury zřízené pro prostředí nasazení. Azure Developer CLI používá k zřizování nových prostředí definice prostředí v katalogu připojeném k vývojovému centru.

Azure Developer CLI funguje s šablonami ARM uloženými v katalogu vývojového centra Azure Deployment Environment. Podporuje také další šablony IaC, jako jsou Bicep a Terraform prostřednictvím modelu rozšiřitelnosti ADE. Informace o konfiguraci modelu rozšiřitelnosti ADE najdete v tématu Model rozšiřitelnosti prostředí nasazení Azure.

K správné podpoře určitých výpočetních služeb Azure vyžaduje Azure Developer CLI v šabloně IaC další nastavení konfigurace. Musíte například označit hostitele služby App Service konkrétními informacemi, aby bylo jasné, azd jak najít hostitele a nasadit do nich aplikaci.

Seznam podporovaných služeb Azure najdete tady: Podporované výpočetní služby Azure (hostitel).

Zajištění kompatibility katalogu ADE s azd

Pokud chcete vývojovým týmům umožnit použití azd s ADE, musíte v katalogu vytvořit definici prostředí, která je kompatibilní s azd. Můžete vytvořit novou azdkompatibilní definici prostředí nebo můžete použít existující definici prostředí z katalogu vývojového centra pro nasazení Azure. Pokud se rozhodnete použít existující definici prostředí, musíte provést několik změn, aby byla kompatibilní s azd.

Zahrnuté změny:

  • Pokud upravujete existující azd šablonu, odeberte složku infra. ADE k vytvoření infrastruktury používá následující soubory:
    • Šablona ARM (azuredeploy.json.)
    • Konfigurační soubor, který definuje parametry (environment.yaml nebo manifest.yaml)
  • Označte prostředky v azure.yaml konkrétními informacemi, aby bylo jasné, azd jak najít hostitele a nasadit do nich aplikaci.

Další informace o tom, jak zajistit kompatibilitu definice azdprostředí ADE, najdete v tématu Zajištění kompatibility projektu s Azure Developer CLI.

Povolení azd podpory v ADE

Pokud chcete povolit azd podporu ADE, musíte nastavit platform.type na "devcenter". Tato konfigurace umožňuje azd využívat nové komponenty vývojářského centra pro stav vzdáleného prostředí a zprovoznění, což znamená, že složka infra ve vašich šablonách je ignorována. Místo toho azd používá jednu ze šablon infrastruktury definovaných v katalogu vašeho vývojářského centra pro zřizování prostředků.

Pokud chcete povolit azd podporu, spusťte následující příkaz:

 azd config set platform.type devcenter

Prozkoumejte azd příkazy

Když je funkce dev center povolená, změní se výchozí chování některých běžných azd příkazů pro práci s těmito vzdálenými prostředími. Další informace najdete v tématu Práce s prostředími nasazení Azure.

Související obsah

  • Last updated on