Sdílet prostřednictvím

Přehled šablon Azure Developer CLI

Šablony Azure Developer CLI (azd) jsou běžná úložiště kódu, která obsahují ukázkový kód aplikace a soubory azd konfigurace a infrastruktury. azd Šablony umožňují zřizovat prostředky Azure, nasazovat aplikaci, konfigurovat kanály CI/CD a provádět další funkce. Můžete buď vytvořit vlastní šablony, nebo začít používat existující šablonu z úložiště šablon, jako je Například Awesome AZD. V tomto článku se seznámíte s následujícími koncepty:

  • Jak azd šablony umožňují zřizovat a nasazovat prostředky aplikací
  • Jak jsou azd strukturovány šablony
  • Jak se rozhodnout, jestli použít existující šablonu nebo vytvořit
  • Prozkoumání existujících azd úvodních šablon

Proč používat šablony Azure Developer CLI?

Vývojáři často čelí mnoha časově náročným a náročným úkolům při vytváření správně navržených a nakonfigurovaných aplikací pracujících s prostředím pro cloud. Týmy musí v těchto prostředích počítat s mnoha různými obavami, jako jsou vytváření prostředků, používání konfigurací, nastavení monitorování a protokolování, vytváření kanálů CI/CD a dalších úloh. azd šablony snižují a zjednodušují tyto odpovědnosti, aby vývojářům pomohly na cestě od místního vývoje k úspěšně nasazené aplikaci v Azure.

Předpokládejme například, že pracujete ve společnosti, která provozuje správu lístků a komunikační platformu zákazníka, která vyžaduje následující prostředky Azure:

  • Dvě instance služby App Service a plán služby App Service pro hostování front-endové webové aplikace a back-endového rozhraní API
  • Instance služby Key Vault pro ukládání zabezpečených tajných kódů aplikací
  • Databáze Cosmos DB pro trvalé ukládání dat aplikací
  • Prostředky Azure Monitor, jako jsou řídicí panely Application Insights
  • Služba Service Bus pro správu škálovatelného zasílání zpráv
  • Kanály CI/CD, které zajišťují spolehlivé nasazení změn prostřednictvím automatizovaného opakovatelného procesu.

Místo toho, abyste začali od základů, můžete s azd využít existující šablony architektury ke zřízení a nasazení většiny prostředků pro vás. Vývojový tým se pak může zaměřit na vytvoření aplikace a provést menší úpravy architektury šablony.

Jak fungují šablony Azure Developer CLI

Šablony Azure Developer CLI jsou navržené tak, aby fungovaly s azd příkazy, jako azd init a azd up. Šablony zahrnují soubory konfigurace a infrastruktury jako kódu (IaC), které jsou používány příkazy k provádění úloh, jako je zřizování prostředků Azure a nasazení kódu aplikace do nich.

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

  1. Spuštěním azd init příkazu s parametrem --template naklonujte existující šablonu z GitHubu dolů.

    azd init --template todo-nodejs-mongo

  2. Spuštěním azd auth login příkazu ověřte předplatné Azure.

    azd auth login

  3. Spuštěním příkazu azd up zřiďte a nasaďte prostředky šablony do Azure. Příkaz azd up využívá soubory konfigurace a infrastruktury jako kódu (IaC) ve vaší šabloně ke zřízení prostředků Azure a nasazení aplikace do těchto prostředků.

    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.

Prozkoumání struktury šablony Azure Developer CLI

azd Šablony jsou standardní úložiště kódu s některými dalšími komponenty. Všechny azd šablony sdílejí podobnou strukturu souborů na azd základě konvencí:

  • infra složka – Obsahuje veškeré soubory kódu infrastruktury v Bicep nebo Terraform pro šablonu azd. azd tyto soubory spustí, aby se vytvořily prostředky Azure potřebné k hostování vaší aplikace.
  • azure.yaml soubor – Konfigurační soubor, který mapuje složky zdrojového kódu v projektu na prostředky Azure definované ve infra složce pro nasazení. Můžete například definovat službu api a webovou front-end službu v samostatných složkách a mapovat je 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 složce – obsahuje veškerý nasaditelný zdrojový kód aplikace. Některé azd šablony vylučují složku src a poskytují pouze infrastrukturní prostředky, abyste mohli přidat vlastní kód aplikace.

Například běžná azd šablona může odpovídat následující struktuře složek:

snímek obrazovky znázorňující strukturu šablony Azure Developer CLI

azd Šablony také volitelně obsahují jednu nebo více následujících složek:

  • .github folder – Obsahuje soubory pracovního postupu 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.
  • .devcontainer folder – Umožňuje nastavit prostředí vývojového kontejneru pro vaši aplikaci.

Začněte s existující šablonou nebo si vytvořte vlastní.

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

  • Začněte s existující azd šablonou.
    • To je dobrá volba, pokud teprve začínáte s azd nebo pokud hledáte šablonu, na které můžete postavit novou aplikaci s podobnou architekturou a frameworky.
  • Převeďte existující projekt na azd šablonu.
    • To je dobrá volba, pokud už máte existující aplikaci, ale chcete ji zajistit kompatibilitu s možnostmi azd .

Následující části obsahují další informace o těchto dvou možnostech.

Začněte s existující šablonou

Široká škála azd šablon je k dispozici v galerii šablon awesome-azd . Tyto šablony poskytují infrastrukturu a kód aplikace pro různé vývojové scénáře, jazykové architektury a služby Azure. Pokud najdete šablonu, která odpovídá místnímu zásobníku aplikací nebo požadované architektuře, můžete kód šablony rozšířit a nahradit vlastním kódem.

Například následující azd šablony poskytují výchozí body pro běžné architektury a architektury aplikací:

Šablona Hostitel aplikací Tech Stack
React Web App with C# API and MongoDB on Azure Azure App Service Azure Cosmos DB for NoSQL, Bicep
React Web App with C# API and SQL Database on Azure Azure App Service Azure SQL Database, Bicep
Statická React webová aplikace + funkce s rozhraním API v jazyce C# a databází SQL na Azure Azure Static Web Apps, Azure Functions Azure SQL Database, Bicep

Vytvoření nové azd šablony pro aplikaci

Existující aplikaci můžete také převést na azd šablonu, která vylepšuje úložiště funkcemi zřizování a nasazení. Tento přístup umožňuje největší kontrolu a vytváří opakovaně použitelné řešení pro budoucí vývoj v aplikaci. Základní kroky pro vytvoření vlastní šablony jsou následující:

  • Inicializujte šablonu projektu pomocí azd init.
  • Vytvořte ve složce infra infrastrukturní soubory jako kód Bicep nebo Terraform.
  • Aktualizujte soubor azure.yaml tak, aby svážely aplikační služby s prostředky Azure.
  • Zavedení & nasadit s azd up.

Následující zdroje informací poskytují další informace o vytváření vlastních šablon:

Pokyny pro používání azd šablon

Upozorňujeme, že každá šablona, kterou používáte s Azure Developer CLI, má licenci příslušného vlastníka (což může nebo nemusí být Microsoft) podle smlouvy, která tuto šablonu doprovází. Je vaší zodpovědností určit, jaká licence se vztahuje na libovolnou šablonu, kterou chcete použít.

Společnost Microsoft nenese odpovědnost za žádné šablony, které nejsou od společnosti Microsoft, a nezkontroloval tyto šablony kvůli problémům se zabezpečením, ochranou osobních údajů, kompatibilitou nebo výkonem. Šablony, které používáte s Azure Developer CLI, včetně těch od Microsoftu, nejsou podporovány žádným programem ani službou podpory Microsoftu. Všechny šablony poskytované společností Microsoft jsou poskytovány tak, jak jsou poskytovány bez záruky jakéhokoli druhu.

Další kroky

Výběr a nasazení šablony

  • Last updated on