Sdílet prostřednictvím

Azure Developer CLI a prostředí nasazení Azure

  • Článek

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 opensourcový nástroj příkazového řádku, který poskytuje příkazy vhodné pro vývojáře, které se mapují na klíčové fáze 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.

azd Jak funguje 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.

Principy azd šablon

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í prostředky:

  • infra folder - Složka infra se nepoužívá s azd ADE. 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 nám azd chcete umožnit vývojovým týmům 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 infra ji. 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 SDE, musíte nastavit platform.type devcenter. Tato konfigurace umožňuje azd používat nové komponenty vývojového centra pro vzdálený stav a zřizování prostředí a znamená, že složka infra ve vašich šablonách se ignoruje. azd Místo toho pro zřizování prostředků používá jednu ze šablon infrastruktury definovaných v katalogu dev Center.

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

 azd config set platform.type devcenter

Prozkoumání azd příkazů

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