Přidání podpory rozhraní příkazového řádku pro vývojáře Azure do aplikace pomocí kódu v adresáři aplikace

Rozhraní příkazového řádku pro vývojáře Azure (azd) poskytuje dva různé pracovní postupy pro inicializaci šablony pro použití s vaší aplikací, mezi které patří:

  • Použijte kód v aktuálním adresáři: Tento přístup analyzuje vaši aplikaci a automaticky generuje podporované prostředky infrastruktury a konfigurace.
  • Vyberte šablonu: Tento přístup umožňuje integrovat existující šablonu s vaší aplikací nebo použít existující šablonu jako výchozí bod pro novou aplikaci.

Oba tyto přístupy jsou popsány v dokumentu Přehled vytváření šablon pro Azure Developer CLI.

V tomto článku se dozvíte, jak do aplikace přidat podporu pro Azure Developer CLI (azd) pomocí přístupu Použití kódu v aktuálním adresáři. Další informace o alternativním přístupu najdete v dokumentaci k přidání azd podpory do aplikace pomocí existujícího dokumentu šablony . Můžete také navštívit školení – sestavení a nasazení azd šablon pro další informace o vytváření azd šablon.

Použijte kód v aktuálním adresáři

  1. Pomocí vlastního projektu můžete postupovat podle kroků dopředu. Pokud ale chcete postupovat podle ukázkové aplikace, naklonujte následující počáteční úložiště do prázdného adresáře v počítači:

    git clone https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart

  2. Otevřete terminál do kořenového adresáře projektu.

  3. Spuštěním azd init příkazu inicializujete šablonu.

    azd init

  4. Po zobrazení výzvy vyberte možnost Použít kód v aktuálním adresáři. azd analyzuje projekt a poskytuje přehled detekovaných služeb a doporučených prostředků hostování v Azure.

  5. Vyberte Potvrdit a pokračovat v inicializaci aplikace. azd vygeneruje v kořenovém adresáři projektu následující soubory:

    • Soubor azure.yaml s odpovídajícími definicemi služby.
    • Složka infra se soubory infrastruktury jako kódu pro zřízení a nasazení projektu do Azure.
    • .azure Složka s proměnnými prostředí nastavenými v souboru .env.

    Další podrobnosti o tomto procesu detekce a generování najdete dále v článku.

  6. Vygenerované soubory fungují as-is pro zadanou ukázkovou aplikaci a můžou také pro vaše vlastní aplikace. V případě potřeby je možné vygenerované soubory upravit tak, aby vyhovovaly vašim potřebám. Pokud vaše aplikace spoléhá na Azure prostředky nad rámec těch, které byly identifikovány infra, může být například potřeba dále upravit soubory infrastruktury jako kódu ve azd složce.

  7. Spuštěním azd up příkazu zřiďte a nasaďte aplikaci do Azure.

    azd up

  8. Po zobrazení výzvy vyberte požadované předplatné a umístění, aby se zahájil proces zřizování a nasazení.

  9. Po dokončení procesu kliknutím na odkaz ve výstupu azd otevřete aplikaci v prohlížeči.

Prozkoumání kroků inicializace

Když vyberete pracovní postup Použít kód v aktuálním adresáři, příkaz azd init analyzuje váš projekt a automaticky vygeneruje kód na základě toho, co zjistí. Níže uvedené části popisují podrobnosti o fungování tohoto procesu a o tom, které technologie jsou aktuálně podporovány.

Detekce

Příkaz azd init rozpozná soubory projektu pro podporované jazyky umístěné v adresáři a podadresářích projektu. azd také kontroluje závislosti balíčků a shromažďuje informace o webových architekturách nebo databázích, které vaše aplikace používá. V případě potřeby můžete zjištěné komponenty přidat nebo upravit ručně, jak je uvedeno v souhrnné výzvě k potvrzení.

Aktuální logika detekce je následující:

  • Podporované jazyky:
    • Python
    • JavaScript/TypeScript
    • platforma .NET
    • Java
  • Podporované databáze:
    • MongoDB
    • PostgreSQL
  • Pro Python a JavaScript/TypeScript se automaticky detekují webové architektury a databáze.
  • Pokud projekt JavaScript/TypeScript používá front-endovou (nebo klientskou) webovou architekturu, klasifikuje se jako front-endová služba. Pokud vaše služba používá front-endovou webovou architekturu, která je aktuálně nedetekovaná, můžete vybrat JQuery a poskytnout ekvivalentní klasifikaci a chování front-endové služby.

Generace

Po potvrzení detekovaných komponent vygeneruje azd init soubory infrastruktury jako kódu potřebné k nasazení aplikace do Azure.

Logika generování je následující:

  • Podporovaní hostitelé:
    • Azure Container Apps.
  • U databází se používá podporované mapování mezi databázovými technologiemi a službou:
    • MongoDB: rozhraní API služby Azure Cosmos DB pro MongoDB
    • PostgreSQL: Azure Database for PostgreSQL Flexible Server
    • Redis: doplněk Redis pro Azure Container Apps
  • Služby používající databáze budou mít proměnné prostředí, které poskytují připojení k databázi předem nakonfigurované ve výchozím nastavení.
  • Pokud jsou zjištěny front-endové i back-endové služby, konfigurace CORS na hostiteli Azure pro back-endové služby se aktualizuje tak, aby povolovala výchozí hostovanou doménu front-endových služeb. To lze podle potřeby upravit nebo odebrat v konfiguračních souborech Infrastruktury jako kódu.

Přidání podpory pro vývojové kontejnery

Šablonu můžete také nastavit jako kompatibilní s vývojovými kontejnery a codespaces. Vývojový kontejner umožňuje používat kontejner jako plnohodnotné vývojové prostředí. Dá se použít ke spuštění aplikace, k oddělení nástrojů, knihoven nebo modulů runtime potřebných pro práci se základem kódu a k podpoře kontinuální integrace a testování. Vývojové kontejnery je možné spouštět místně nebo vzdáleně v privátním nebo veřejném cloudu. (Zdroj: https://containers.dev/)

Přidání podpory pro vývojové kontejnery:

  1. Vytvořte složku .devcontainer v kořenovém adresáři projektu.

  2. Vytvořte soubor devcontainer.json ve složce .devcontainer s požadovanými konfiguracemi. Úvodní azd šablona obsahuje ukázkový devcontainer.json soubor, který můžete zkopírovat do projektu a podle potřeby upravit.

Další informace o práci s vývojovými kontejnery najdete v dokumentaci k Visual Studio Code.

Přidání podpory pro kanál CI/CD

Podporu CI/CD můžete do šablony přidat také pomocí akcí GitHub nebo Azure DevOps pomocí následujících kroků:

  1. .github Přidejte složku pro GitHub akce nebo .ado složku pro Azure DevOps do kořenového adresáře projektu.

  2. Do nové složky přidejte soubor pracovního postupu. Úvodní azd šablona poskytuje ukázkový soubor pracovního postupu GitHub Actions a ukázkový soubor Azure DevOps Pipelines pro každou platformu. Tyto soubory můžete zkopírovat do projektu a podle potřeby je upravit.

  3. Je také možné, že budete muset aktualizovat main.parameters.json soubor ve složce infra požadovanými proměnnými prostředí pro spuštění pracovního postupu.

  • Last updated on