Sdílet prostřednictvím

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:

  • 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.

Zvolte přístup, který nejlépe vyhovuje vašemu projektu. Všechny tyto toky jsou podrobněji popsány v přehledu šablon a souvisejících článcích. Následující části obsahují koncepční přehled jednotlivých toků.

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. azd init Spusťte příkaz:

    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. Stisknutím klávesy Enter šablonu naklonujete a inicializujete.

  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 stiskněte 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.
Run azd add to add new Azure components to your project.

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

    • Základní azure.yaml soubor s pouze názvem projektu a schemaVersion
    • .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
    • Plánujte použít azd add příkaz ke přírůstkovému sestavení vaší architektury
    • Preferujte plnou kontrolu nad strukturou projektu.

  3. Po inicializaci můžete:

    • Ruční vytvoření souborů infrastruktury ve infra složce
    • azd add Použijte funkci sestavení k zahájení přidávání prostředků Azure do vaší aplikace
    • Přizpůsobte svůj soubor azure.yaml pro definování služeb a prostředků

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