Prozkoumání pracovních postupů inicializace Azure Developer CLI

Azure Developer CLI (azd) poskytuje sadu příkazů pro zjednodušení vývoje, zřizování a nasazování aplikací v Azure. Příkaz azd init vám pomůže nastavit nové nebo existující projekty generováním souborů a konfigurací potřebných pro práci s azd. Tento článek vysvětluje různé dostupné pracovní postupy inicializace a způsob výběru nejlepší možnosti pro váš vývojový scénář.

Pracovní postupy inicializace

Příkaz azd init podporuje několik pracovních postupů pro přípravu aplikace na práci s azd:

  • Nastavení pomocí GitHub Copilot (Preview): Spustí vyhrazenou relaci agenta Copilot, která může naplánovat projekt, generovat prostředky šablony a ověřit výsledek.
  • Prohledávat aktuální adresář: Analyzuje existující základ kódu aplikace a vygeneruje odpovídající azd konfigurační soubory a prostředky.
  • Vyberte šablonu: Klonuje a inicializuje šablonu z azdgalerie šablon.
  • Vytvořte minimální projekt: Inicializuje základní azure.yaml soubor jako výchozí bod pro vytvoření vlastní azd šablony od začátku.

Pro vývoj šablon použijte možnost Nastavit pomocí GitHub Copilota (Preview). Přehled celého životního cyklu vytváření najdete v přehledu vývoje šablon. Následující části popisují každý pracovní postup inicializace.

Nastavení pomocí GitHub Copilot (Preview)

Pomocí tohoto pracovního postupu můžete vytvořit šablonu s pomocí AI. azdspustí vyhrazenou relaci agent Copilota GitHubu, která může zkontrolovat existující soubory projektu nebo vám pomůže naplánovat nový projekt. Agent generuje standardní azd artefakty, jako jsou azure.yaml, soubory Bicep nebo Terraform a konfigurace kontejnerů, a následně výsledek ověří.

Relace agenta probíhá v terminálu a nenavazuje na aktivní relaci GitHub Copilot Chat v aplikaci Visual Studio Code. Požadavky a podrobné pokyny najdete v tématu Začínáme s novou šablonou.

Kontrola aktuálního adresáře

Tento pracovní postup použijte, pokud máte existující základ kódu aplikace a chcete ho připravit na nasazení do Azure pomocí azd.

  1. Přejděte do kořenového adresáře projektu.

  2. Spusťte příkaz azd init.

    azd init

  3. Vyberte Vyhledat aktuální adresář. azd bude:

    • Zkontrolujte adresář a určete jazyk nebo architekturu, které vaše aplikace používá.
    • Vyberte příslušnou platformu pro hostování, například Azure Container Apps.
    • V případě potřeby se zobrazí výzva k přidání nebo odebrání zjištěných služeb.
    ? How do you want to initialize your app? Scan current directory

  (✓) Done: Scanning app code in current directory

Detected services:

  .NET
  Detected in: src

azd will generate the files necessary to host your app on Azure using Azure Container Apps.

? Select an option  [Use arrows to move, type to filter]
> Confirm and continue initializing my app
  Remove a detected service
  Add an undetected service

  4. Výběrem možnosti Potvrdit a pokračovat v inicializaci aplikace dokončete pracovní postup. azd vytvoří v adresáři vaší aplikace následující:

    • Soubor azure.yaml, který definuje služby aplikací a mapuje je na hostitelské prostředky.
    • Složka .azure pro uložení nastavení konfigurace, jako je název vašeho prostředí.
    • Soubor .gitignore nakonfigurovaný pro jazyk vaší aplikace a platformu hostování

  5. Volitelně můžete spustit azd up , abyste vytvořili prostředky Azure Container Apps a nasadíte aplikaci.

Vaše aplikace je teď strukturovaná jako azd šablona, kterou můžete dál vyvíjet a rozšiřovat s dalšími prostředky a službami Azure.

Výběr šablony

Tento pracovní postup umožňuje začít s předem připravenou azd šablonou, která obvykle obsahuje kód aplikace i nezbytné definice infrastruktury Azure.

  1. azd init Spusťte příkaz:

    azd init

    Poznámka:

    Můžete také spustit azd init s parametrem --template pro přímou inicializaci šablony podle názvu a přeskočit výběr pracovního postupu.

  2. Zvolte Vybrat šablonu. azd zobrazí seznam dostupných šablon z nakonfigurovaných zdrojů šablon.

    ? How do you want to initialize your app? Select a template
? Select a project template:  [Use arrows to move, type to filter]
> Deploy Phoenix to Azure
  (Arize-ai/phoenix-on-azure)

  API Center Reference Sample
  (Azure-Samples/APICenter-Reference)

  Event Driven Java Application with Azure Service Bus on Azure Spring Apps
  (Azure-Samples/ASA-Samples-Event-Driven-Application)

  Static React Web App with Java API and PostgreSQL
  (Azure-Samples/ASA-Samples-Web-Application)

  3. Zadáním vyfiltrujte výsledky a vyhledejte Hello AZD šablonu. Vyberte šablonu, která se má klonovat a inicializovat.

  4. Volitelně můžete spustit azd up ke zřízení a nasazení prostředků šablony do Azure.

Inicializovaná šablona můžete také použít jako výchozí bod pro další vývoj.

Vytvoření minimálního projektu

Pro pokročilé uživatele, kteří chtějí začít s minimálním nastavením a přizpůsobit vše ručně, tato možnost poskytuje pouze základní konfiguraci.

  1. azd init Spusťte příkaz s příznakem--minimal:

    azd init --minimal

  2. Po zobrazení výzvy zadejte název azd šablony a vyberte Enter.

    ? How do you want to initialize your app? Create a minimal project
? What is the name of your project? (empty) hello-azd
? What is the name of your project? hello-azd

SUCCESS: Generated azure.yaml project file.

    Příznak --minimal vytvoří pouze následující:

    • Základní azure.yaml soubor s názvem projektu
    • .azure Adresář pro konfiguraci prostředí
    • .gitignore Soubor s odpovídajícími položkami pro Azure Developer CLI

    Tato zjednodušená inicializace je ideální v těchto případech:

    • Chcete vytvořit infrastrukturu od začátku
    • Potřeba integrace azd s existujícím komplexním projektem
    • Preferujte plnou kontrolu nad strukturou projektu.

  3. Dokončete konfiguraci projektu. Soubory infrastruktury můžete vytvořit ručně ve složce infra, požádat agenta AI pro psaní kódu, aby infrastrukturu vytvořil, a upravit azure.yaml pro definování svých služeb a zdrojů.

Pojmenování prostředků Projectu a Azure

Při inicializaci nového nebo existujícího projektu je název projektu nastaven v azure.yaml. Název projektu funguje jako předpona pro názvy prostředků Azure vytvořené během procesu zřizování. Dodržováním ověřovacích pravidel zajistíte, že vygenerované názvy prostředků Azure budou také platné.

V šablonách Bicep nebo Terraform se název projektu často používá jako základ pro vytváření názvů prostředků v kombinaci s názvem prostředí a dalšími prvky. Například:

var resourceToken = '${name}-${environmentName}'

Kde name odkazuje na název projektu a environmentName je název vašeho azd prostředí.

Ověřovací pravidla názvu projektu

Při inicializaci azd init projektu nebo při vytváření nového názvu projektu v azure.yaml souboru se použijí následující ověřovací pravidla:

Pravidlo Description
Povolené znaky Názvy projektů můžou obsahovat jenom malá písmena, číslice a pomlčky.
Počáteční znak Názvy projektů musí začínat písmenem.
Koncový znak Názvy projektů nesmí končit spojovníkem.
Délka Názvy projektů musí mít délku 2 až 63 znaků.
Žádné po sobě jdoucí pomlčky Názvy projektů nemohou obsahovat po sobě jdoucí pomlčky.

Tato ověřovací pravidla zajišťují, že název vašeho projektu bude kompatibilní s požadavky na pojmenování prostředků Azure a zabrání selhání balení služeb během nasazování.

Další kroky

Po inicializaci projektu pomocí azd init:

  • Upravte vygenerované soubory infrastruktury, abyste mohli přizpůsobit prostředky Azure.
  • Použijte azd provision k vytvoření požadovaných prostředků v Azure.
  • Použijte azd deploy k nasazení kódu aplikace do zřízených prostředků.
  • Seznamte se s pracovním postupem Azure Developer CLI pro kombinování zřizování a nasazení v jednom příkazu.

Související obsah

  • Last updated on