Přehled vývoje šablon rozhraní příkazového řádku pro vývojáře Azure (azd)

Šablony Azure Developer CLI (azd) obsahují konfiguraci, infrastrukturu a volitelný kód aplikace potřebné ke zprovoznění a nasazení řešení v Azure. Šablonu můžete použít pro aplikaci, projekt jen pro infrastrukturu nebo opakovaně použitelný výchozí bod pro budoucí projekty.

Note

Než začnete, přečtěte si Azure šablony rozhraní příkazového řádku pro vývojáře, kde najdete úplný popis struktury šablon, požadovaných a volitelných prostředků, přidružení mezi službami a prostředky a způsob azd použití příkazů jednotlivých souborů.

Pracovní postup vývoje šablon

Následující pracovní postup platí bez ohledu na to, jestli vytvoříte šablonu nebo inicializujete šablonu, která již existuje:

Diagram pracovního postupu vývoje šablon azd od výběru výchozího bodu spuštěním a údržbou šablony

Diagram pracovního postupu vývoje šablon rozhraní příkazového řádku pro vývojáře Azure Na levé straně obsahuje pole označené jako "Zvolit výchozí bod" dvě možnosti: "Začít s novou šablonou" a "Začít z existující šablony". Obě možnosti vedou k prozkoumání a úpravám souborů šablony. Odtud volitelná cesta vede dolů k „Rozšířit šablonu“ a hlavní cesta pokračuje k „Spustit azd up“. Krok „Rozšíření šablony“ také vede ke kroku „Spusťte azd up.“ Nakonec spuštění příkazu „azd up“ vede až ke kroku „Udržovat nebo sdílet šablonu“.

  • Zvolte výchozí bod:Začněte novou šablonou s integrací GitHub Copilot, jiným pomocníkem pro kódování AI nebo přímým vytvářením obsahu. Případně můžete začít od existující šablony z Microsoft, vaší organizace nebo komunity vývojářů.
  • Prozkoumejte a upravte soubory: Přečtěte si, jak azure.yamlspolečně fungují Bicep nebo soubory Terraformu, kód aplikace a podpora konfigurace. Viz Prozkoumání a úprava souborů šablon.
  • Rozšíření a vývoj podle potřeby: Přidání, nahrazení, odebrání nebo změna návrhu součástí aplikace a infrastruktury Postupujte podle pokynů v části Extend a template, kde najdete komplexní příklad, který přidá prostředek Azure a propojí ho s aplikací.
  • Zřízení a nasazení: Spuštěním azd up zřiďte infrastrukturu a nasaďte všechny aplikační služby. Další informace najdete v tématu Prozkoumání azd up pracovního postupu.
  • Údržba nebo sdílení: Pokračujte v úpravách šablony při vývoji projektu. Pokud ho chcete sdílet, nejprve ho otestujte v čistém adresáři a s novým azd prostředím.

Note

V tomto pracovním postupu můžete vytvářet, upravovat nebo nahrazovat soubory šablon sami nebo pomocí pomocníka pro kódování AI. Výsledkem je stejná sada standardních a upravitelných azd prostředků.

Stavební bloky šablon

Každá azd šablona podporuje jiné řešení, ale většina šablon kombinuje stejné typy prostředků:

  • konfigurace Project: Soubor azure.yaml identifikuje project, nasaditelné služby, zdrojové adresáře, cíle hostování a volitelné háky nebo pracovní postupy.
  • Infrastruktura jako kód: Bicep nebo soubory Terraformu definují prostředky Azure, přiřazení rolí, sítě a nastavení aplikací, které řešení vyžaduje.
  • Zdroj aplikace: Šablona může obsahovat jednu nebo více nasaditelných aplikací nebo může obsahovat pouze infrastrukturu.
  • Konfigurace prostředí: Parametry předávají do nasazení hodnoty specifické pro prostředí a výstupy infrastruktury se stanou hodnotami v aktivním azd prostředí.

Šablona aplikace může používat následující strukturu složek:

.
├── azure.yaml                # Project configuration
├── infra/                    # Infrastructure as code
│   ├── main.bicep
│   ├── main.parameters.json
│   └── modules/
├── src/                      # Application source
│   ├── api/
│   └── web/
├── .github/                  # Pipeline workflows
│   └── workflows/
└── README.md

Přesná struktura se liší podle projektu. Zdroj aplikací, moduly infrastruktury a soubory kanálů jsou volitelné a azure.yaml identifikují cesty, které azd používají. Tyto prostředky spolupracují v průběhu životního cyklu vývoje šablon.

Další kroky

Požádat o pomoc

Informace o tom, jak nahlásit chybu, požádat o pomoc nebo navrhnout novou funkci pro rozhraní příkazového řádku vývojářů Azure, najdete na stránce řešení problémů a podpora.