Přehled vytváření šablon rozhraní příkazového řádku pro vývojáře Azure

Rozhraní příkazového řádku pro vývojáře Azure (azd) využívá templates ke zřizování a nasazování 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í specifických konfiguračních a infrastrukturních prostředků do vaší stávající základny kódu, nebo zahájení nové aplikace z nějaké existující šablony s tytéž 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 služby aplikace 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, na kterých azd závisí pro příkazy jako azd up.

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

Pracovní postupy vytváření šablon

Příkaz azd init slouží k inicializaci šablony azd pro zřizování a nasazování prostředků aplikace na 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žijte kód v aktuálním adresáři

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

Navštivte kurz Začněte s kódem vaší aplikace k vytvoření šablony, kde najdete podrobnosti o tom, jak tento přístup implementovat, a další informace o tom, které prostředky na Azure podporují automatické zjišťování a generování struktury kódu.

Výběr šablony

Tuto možnost vyberte, pokud chcete použít existující šablonu, která definuje mnoho vašich Azure prostředků 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 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.

Další kroky

Azure Nejčastější dotazy k rozhraní příkazového řádku pro vývojáře