Přehled vytváření šablon Azure Developer CLI

Azure Developer CLI (azd) využívá šablony ke zřízení a nasazení prostředků aplikace do cloudu. Vývojáři můžou přidat podporu příkazů azd a funkcí převodem aplikací na šablony. Tento článek obsahuje kontextový přehled různých možností vytváření azd šablon. Jakmile porozumíte konceptům v tomto článku, navštivte následující zdroje informací o podrobnějších průvodcích implementací:

• Použijte existující šablonu pro vaši aplikaci.
• Vytvoření šablony z kódu aplikace
• Školení – sestavení a nasazení azd šablon

Poznámka:

Tento článek předpokládá obecné znalosti azd šablon. Další informace o šablonách najdete v dokumentu s přehledem šablon.

Koncepty vytváření šablon

azd Vytvoření šablony vyžaduje přidání konkrétních prostředků konfigurace a infrastruktury do existujícího základu kódu nebo spuštění nové aplikace z existující šablony stejné prostředky. Oba pracovní postupy jsou vysvětlené v dalších částech. Všechny azd šablony sdílejí podobnou strukturu souborů založenou na azd konvencích. Následující diagram poskytuje rychlý přehled procesu vytvoření azd šablony:

Každá azd šablona vyžaduje následující minimální prostředky:

• Složka infra , která obsahuje infrastrukturu jako soubory kódu (Bicep nebo Terraform).
• azure.yaml Konfigurační soubor, který mapuje aplikační služby na zřízené prostředky infrastruktury.

Další volitelné adresáře jsou často zahrnuty také, například .github složka s prostředky pro vytvoření kanálu CI/CD. Další informace o šablonách najdete v dokumentu s přehledem šablon.

Představte si následující úložiště ukázkových aplikací:

Po převodu azd této ukázkové aplikace na šablonu obsahuje stejné úložiště aplikací následující:

Původní prostředky aplikace se nezměnily, ale byly přidány nové prostředky, které azd závisí na příkazech, jako azd upnapříklad:

• Byla infra přidána složka, která obsahuje soubory Bicep pro vytvoření prostředků Azure.
• Byl azure.yaml přidán konfigurační soubor pro mapování kódu aplikace v src adresáři na zřízené prostředky Azure.
• Složka .azure byla vytvořena pro uložení azd proměnných prostředí.
• Byla .github přidána složka (volitelná), která podporuje kanály CI/CD prostřednictvím GitHub Actions.

Pracovní postupy vytváření šablon

Příkaz azd init slouží k inicializaci azd šablony pro zřizování a nasazování prostředků aplikace v Azure. Příkazový řádek vás vyzve k výběru mezi dvěma různými pracovními postupy pro inicializaci šablony, která je uvedena v následujících částech – Použijte kód v aktuálním adresáři a použijte existující šablonu.

azd init Spusťte příkaz v kořenovém adresáři, který chcete převést naazd template:

azd init

Použití kódu v aktuálním adresáři

Tato možnost dává pokyn azd k analýze kódu v adresáři na identitu, které technologie používá, jako je programovací jazyk, architektura a databázový systém. azd automaticky generuje prostředky šablony, jako azure.yaml je například definiční soubor služby a infra složka se soubory infrastruktury jako kódu. Vygenerované prostředky jsou výchozím bodem pro další úpravy. Tento přístup použijte, pokud plánujete používat běžné služby Azure podporované funkcemi azd generování uživatelského rozhraní.

Přejděte do kurzu Začínáme s kódem aplikace a vytvořte kurz šablony , kde najdete podrobnosti o tom, jak tento přístup implementovat, a další informace o tom, které prostředky Azure podporují automatické zjišťování a generování uživatelského rozhraní.

Výběr šablony

Tuto možnost vyberte, pokud chcete použít existující šablonu, která definuje mnoho vašich prostředků Azure a cílů architektury jako výchozí bod. azd vás vyzve k výběru úvodní šablony nebo jiné šablony z galerie awesome-azd . Když vyberete šablonu, prostředky této šablony se přidají do existujícího adresáře projektu, aby se používaly jako výchozí bod. Některé šablony zahrnují ukázkový kód aplikace, který můžete nahradit vlastním kódem, zatímco některé (označované jako "úvodní šablony") jsou pouze infrastruktura.

azd init Pomocí příkazu stáhněte existující šablonu do prázdného adresáře a použijte ji jako výchozí bod pro vlastní aplikaci. Pokud šablona obsahuje zdrojový kód aplikace, můžete buď vytvořit tento kód, nebo nahradit adresář zdrojového kódu vlastním kódem.

Podrobnosti o implementaci tohoto přístupu najdete v kurzu Začínáme s existující šablonou .

Viz také

• Použijte existující šablonu pro vaši aplikaci.
• Vytvoření šablony z kódu aplikace

Požádat o pomoc

Informace o tom, jak vytvořit chybu, požádat o pomoc nebo navrhnout novou funkci pro Azure Developer CLI, najdete na stránce pro řešení potíží a podporu .

Další kroky

Nejčastější dotazy k Azure Developer CLI