Jak funguje Azure Developer CLI

Dokončeno

Rozhraní příkazového řádku Azure (azd) je postavené na příkazech pro vývojáře a základních šablonách aplikací. azd poskytuje sadu příkazů, které pomáhají připojit a spravovat aplikaci v Azure pomocí standardizovaných šablon projektů. Tyto šablony zahrnují všechny nezbytné zdrojové kódy a konfigurační prostředky pro zřízení a nasazení aplikace do Azure. Můžete začít používat azd tím, že buď odpracujete některou ze stávajících a rozšiřitelných ukázkových šablon, nebo si vytvoříte vlastní.

Prozkoumejte příkazy azd

Azure Developer CLI obsahuje přístupnou sadu příkazů, které se mapují na běžné fáze pracovních postupů vývoje, jako je zřizování a nasazování prostředků. Některé azd příkazy, jako je azd up, také zpracovávají více fází najednou, aby se tyto úlohy dále zjednodušily.

Typický pracovní postup azd pomocí existující šablony například zahrnuje následující kroky:

1. Spuštěním příkazu azd init s parametrem --template naklonujte existující šablonu a po zobrazení výzvy nastavte název prostředí.

   azd init --template todo-nodejs-mongo
   

2. Spuštěním příkazu azd auth login se přihlaste k předplatnému Azure.

   azd auth login
   

3. Spuštěním příkazu azd up zřiďte a nasaďte prostředky šablony do Azure.

   azd up
   

4. Po nastavení prostředí v Azure můžete místně upravit funkce aplikací nebo šablony prostředků Azure a pak znovu spustit azd up a zřídit změny.

Další příkazy azd jsou k dispozici k dokončení dalších úkolů a rozbalení tohoto pracovního postupu. azd je navržený tak, aby měl minimální počet příkazů s několika parametry pro snadné použití. Mezi nejběžnější příkazy azd patří:

• azd init – inicializujte novou aplikaci.
• Zajištění – Zajištění prostředků Azure a nasazení projektu pomocí jednoho příkazu
• zřízení azd – Zřízení prostředků Azure pro aplikaci
• azd nasazení - Nasazení kódu aplikace do Azure.
• azd pipeline – (beta verze) Spravujte a konfigurujte své nasazovací pipeline.
• ověření Azd – Ověření s Azur
• konfigurace azd – správa konfigurací azd (například výchozí předplatné Azure, umístění).
• dolů – Odstraňte prostředky Azure pro aplikaci.

Prozkoumání šablon azd

Příkazy Azure Developer CLI jsou navržené tak, aby fungovaly se standardizovanými šablonami projektů. Každá šablona je úložiště kódu, které dodržuje specifické konvence souborů a složek. Šablony obsahují prostředky, které azd potřebuje pro zřízení prostředků Azure a volitelně nasazení zdrojového kódu aplikace. Některé šablony nemusí obsahovat zdrojový kód aplikace za předpokladu, že přidáváte vlastní. Když spustíte příkaz, například azd up, nástroj pomocí prostředků šablony projektu provede různé kroky pracovního postupu, jako je zřizování nebo nasazování prostředků do Azure.

Práce se šablonami azd má dva hlavní přístupy:

• Rozšíření existující šablony azd – existuje velká knihovna šablon azd, která zahrnuje běžné místní sady aplikací, scénáře a architektury. Mnoho šablon můžete procházet na webu knihovny šablon awesome-azd. Pokud najdete šablonu, která odpovídá vašemu místnímu zásobníku aplikací nebo vámi požadované architektuře, můžete ji použít jako výchozí bod. Potom nahraďte adresář zdrojového kódu a upravte soubory konfigurace nebo infrastruktury tak, aby vyhovovaly vašim potřebám.

• Převeďte vlastní aplikaci na šablonu azd – Můžete také převést existující aplikaci na azd template pomocí průvodce Učiňte svůj projekt kompatibilním s azd. Vytvoření vlastní šablony je na začátku často více práce, ale umožňuje nejvíce kontroly a vytváří opakovaně použitelné řešení pro budoucí vývoj práce v aplikaci. Základní kroky pro vytvoření vlastní šablony jsou následující:

  • Inicializujte šablonu projektu pomocí azd init.

  • Vytvořte infrastrukturu jako soubory kódu pomocí Bicep nebo Terraformu.

  • Aktualizujte soubor azure.yaml tak, aby svážely aplikační služby s prostředky Azure.

  • Zavedení & nasadit s azd up.

    

Bez ohledu na to, který přístup zvolíte, je výsledná struktura šablony stejná. Všechny šablony azd zahrnují následující materiály:

• infra složka – Obsahuje veškeré soubory kódu infrastruktury v Bicep nebo Terraform pro šablonu azd. Infrastruktura jako kód umožňuje definovat prostředky a konfigurace infrastruktury v deklarativních definičních souborech, které spolehlivě generují stejná prostředí při každém nasazení. Terraform funguje napříč několika cloudovými platformami, zatímco Bicep je specifický pro Azure. azd tyto soubory spustí, aby se vytvořily prostředky Azure potřebné k hostování vaší aplikace. Další informace o infrastruktuře jako kódu najdete v Co je infrastruktura jako kód? trénovací modul.

• azure.yaml soubor – 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í.

• .azure složek – obsahuje základní konfigurace Azure a proměnné prostředí, jako je umístění pro nasazení prostředků nebo jiné informace o předplatném.

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

  

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

• .devcontainer složek – Umožňuje nastavit prostředí vývojového kontejneru pro vaši aplikaci. Běžný přístup k vývojovému prostředí, který není specifický pro azd.
• .github složky – obsahuje soubory pracovních postupů CI/CD pro GitHub Actions, výchozího poskytovatele CI/CD pro azd.
• .azdo složce – Pokud se rozhodnete použít Azure Pipelines pro CI/CD, definujte konfigurační soubory pracovního postupu v této složce.