Začínáme s novou šablonou rozhraní příkazového řádku pro vývojáře Azure (azd)

K sestavení standardních souborů v nové šabloně rozhraní příkazového řádku proazd vývojáře Azure () můžete použít různé metody vytváření:

  • Použijte integraci GitHub Copilot v azd init. Integrovaný pracovní postup analyzuje existující soubory projektu nebo vám pomůže naplánovat nový projekt, vytvoří prostředky šablony a spustí ověření předběžného nasazení.
  • Použijte jiného pomocníka pro kódování AI. Požádejte asistenta, aby vytvořil stejnou azure.yamlinfrastrukturu jako kód, aplikaci a podpůrné soubory bez přímé integrace s azd init.
  • Vytvořte soubory přímo. Sami vytvářejte a upravujte prostředky šablon, pokud chcete mít úplnou kontrolu nebo nepoužíváte AI asistenta pro psaní kódu.

Tento článek se zaměřuje především na integrovaný pracovní postup GitHub Copilot, protože nabízí řízené prostředí integrované s azd. Bez ohledu na metodu vytváření zkontrolujte a ověřte každý soubor před nasazením.

Important

Integrace GitHub Copilot v azd init je ve verzi Preview. Funkce ve verzi Preview se můžou změnit před obecnou dostupností. Další informace najdete ve azd strategii správy verzí a verzí funkcí.

Vygenerované assety jsou standardní, upravitelné azd soubory šablon. Po inicializaci je můžete aktualizovat přímo nebo pomocí libovolného pomocníka pro kódování AI.

Požadavky pro GitHub Copilot

Pokud chcete použít předdefinovaný pracovní postup Copilot, potřebujete:

  • Azure Developer CLI 1.23.11 nebo novější.
  • Aktivní GitHub Copilot předplatné.
  • Git, který azd init používá ke kontrole pracovního stromu před úpravou souborů.
  • Interaktivní terminálová relace.

Pokud ještě nejste ověřeni pomocí GitHub Copilot, azd zobrazí se výzva k přihlášení.

Spusťte azd version, chcete-li zkontrolovat nainstalovanou verzi Azure Developer CLI.

Note

Pracovní postup azd init spustí v terminálu vyhrazenou relaci agenta GitHub Copilot. Ve Visual Studio Code nepoužívá aktivní relaci GitHub Copilot Chat ani v ní nepokračuje.

Vytvářejte s GitHub Copilot

  1. Otevřete terminál v adresáři, ve kterém chcete vytvořit šablonu.

    Note

    Adresář může obsahovat existující aplikaci, projekt infrastruktury nebo počáteční soubory pro nové řešení. Pokud adresář obsahuje nepotvrzené změny, azd před pokračováním vás požádá o potvrzení. Nejprve potvrďte nebo zachytejte důležité změny.

  2. Spusťte azd init:

    azd init
    
  3. Vyberte Nastavit pomocí GitHub Copilot (Preview).

    Výzva k inicializaci se podobá následujícímu příkladu:

    ? How do you want to initialize your app?
       Scan current directory
       Select a template
    > Set up with GitHub Copilot (Preview)
    
  4. Zkontrolujte požadovaný přístup k nástrojům a udělte přístup k nástrojům požadovaným pro pracovní postup. Copilot používá azd a Azure možnosti vývoje ke kontrole projektu, vytváření souborů a ověření výsledku.

  5. Pokud se zobrazí výzva k jejich konfiguraci, vyberte model a úroveň azd odůvodnění.

    Při prvním spuštění výzvy používají následující popisky. Dostupné možnosti modelu a odůvodnění závisí na vašem GitHub Copilot účtu a vybraném modelu:

    ? Select AI model
    ? Select reasoning effort level
    
  6. Popište, co chcete vytvořit. Uveďte relevantní požadavky, například:

    • Bez ohledu na to, jestli šablona obsahuje kód aplikace, pouze infrastrukturu nebo obojí.
    • Jazyky a architektury aplikací, pokud jsou známé.
    • Služby Azure a hostitelská platforma, která se má použít.
    • Ať už používáte Bicep nebo Terraform.
    • Požadavky na zabezpečení, sítě, škálování a oblasti

    Příklady:

    Build an infrastructure-only azd template that provisions an Azure Container Apps
    environment, Azure Container Registry, and Log Analytics workspace with Bicep.
    Use managed identity and least-privilege role assignments. Parameterize the location
    and environment name so the template can be reused.
    
  7. Odpovězte na jakékoli dotazy týkající se architektury nebo konfigurace z Copilot. Agent připraví projekt pro Azure, vygeneruje prostředky šablon a spustí ověření předběžného nasazení.

  8. Zkontrolujte celkovou strukturu souborů, které Copilot vytvořil nebo změnil. Ověřte, že šablona obsahuje očekávanou konfiguraci projektu, adresář infrastruktury, zdroj aplikace a podpůrné prostředky pro vaše řešení.

    Vygenerovaná šablona jen pro infrastrukturu může například obsahovat následující soubory klíčů:

    azure.yaml
    infra/
    ├── main.bicep
    ├── main.parameters.json
    └── modules/
       ├── container-apps-environment.bicep
       └── container-registry.bicep
    

    Podrobné pokyny ke kontrole obsahu konfigurace a infrastruktury najdete v tématu Prozkoumání a úprava souborů šablon.

Zřízení a nasazení šablony

Po schválení vygenerovaných souborů spusťte následující příkaz:

azd up

Příkaz vytvoří nebo vybere azd prostředí, zřídí Azure prostředky, zabalí všechny aplikační služby a nasadí je. Podrobný rozpis příkazů najdete v tématu Prozkoumání azd up pracovního postupu.

Použití jiné metody vytváření obsahu

Ostatní asistenti AI pro programování nejsou přímo připojeni k pracovnímu postupu azd init, ale mohou vytvořit stejné standardní soubory šablony. Každý asset můžete také přímo vytvářet.

Vytvořte si tyto prostředky sami nebo požádejte jiného pomocníka pro kódování, aby analyzoval vaše požadavky a vytvořil je:

  • Soubor azure.yaml , který definuje projekt a nasaditelné služby.
  • Soubory Bicep nebo Terraform, které nasazují požadované prostředky v Azure.
  • Výstupy prostředků a proměnné prostředí aplikace.
  • soubory Dockerfile, konfigurace nasazení a podpůrné skripty podle potřeby.

Pokud chcete poskytnout minimální výchozí bod před použitím jiného agenta, spusťte:

azd init --minimal

Pokud používáte jiného pomocníka pro kódování, požádejte ho, aby postupoval podle azure.yaml schématu, Azure postupů zabezpečení infrastruktury a konvencí šablon popsaných v šablonách rozhraní příkazového řádku pro vývojáře Azure. Pokud soubory vytvoříte přímo, použijte stejné odkazy jako v průvodci implementací. Před spuštěním azd upzkontrolujte a ověřte všechny soubory.

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.