Börja med en ny cli-mall för Azure developer (azd)

Du kan använda olika redigeringsmetoder för att skapa standardfilerna i en ny cli-mall för Azure Developer (azd):

  • Använd GitHub Copilot-integreringen i azd init. Det inbyggda arbetsflödet analyserar befintliga projektfiler eller hjälper dig att planera ett nytt projekt, skapar malltillgångarna och kör fördistributionsverifiering.
  • Använd en annan AI-kodningsassistent. Be assistenten att skapa samma azure.yaml, infrastruktur som kod, program och stödfiler utan att integrera direkt med azd init.
  • Skapa filerna direkt. Skapa och redigera malltillgångarna själv när du vill ha fullständig kontroll eller inte använder en AI-kodningsassistent.

Den här artikeln fokuserar främst på det inbyggda GitHub Copilot arbetsflödet eftersom det ger en guidad upplevelse som är integrerad med azd. Oavsett redigeringsmetod granskar och validerar du varje fil före distributionen.

Important

Integreringen av GitHub Copilot i azd init är i förhandsversion. Förhandsversionsfunktioner kan ändras före allmän tillgänglighet. Mer information finns i azd strategin för versionshantering och lansering av funktioner.

De genererade tillgångarna är standard, redigerbara azd mallfiler. Efter initieringen kan du uppdatera dem direkt eller med någon AI-kodningsassistent.

Förutsättningar för GitHub Copilot

Om du vill använda det inbyggda Copilot arbetsflödet behöver du:

  • Azure Developer CLI 1.23.11 eller senare.
  • En aktiv GitHub Copilot-prenumeration.
  • Git, som azd init använder för att inspektera arbetsträdet innan filer ändras.
  • En interaktiv terminalsession.

Om du inte redan har autentiserats med GitHub Copilot azd uppmanas du att logga in.

Kör azd version för att kontrollera den installerade Azure Developer CLI-versionen.

Notera

Arbetsflödet azd init startar en dedikerad GitHub-Copilot-agent-session i terminalen. Den använder inte eller fortsätter inte en aktiv GitHub-Copilot Chat session i Visual Studio Code.

Skapa med GitHub Copilot

  1. Öppna en terminal i katalogen där du vill skapa mallen.

    Notera

    Katalogen kan innehålla ett befintligt program, ett infrastrukturprojekt eller de första filerna för en ny lösning. Om katalogen innehåller icke-bekräftade ändringar azd ber du dig bekräfta innan du fortsätter. Genomför eller spara viktiga ändringar först.

  2. Kör azd init:

    azd init
    
  3. Välj Konfigurera med GitHub Copilot (förhandsgranskning).

    Initieringsprompten liknar följande exempel:

    ? How do you want to initialize your app?
       Scan current directory
       Select a template
    > Set up with GitHub Copilot (Preview)
    
  4. Granska den begärda verktygsåtkomsten och bevilja åtkomst till de verktyg som krävs för arbetsflödet. Copilot använder azd och Azure utvecklingsfunktioner för att inspektera projektet, skapa filer och verifiera resultatet.

  5. Välj en modell och en resonemangsnivå om azd uppmanar dig att konfigurera dem.

    Första gången används följande etiketter för uppmaningarna. Vilka modell- och resonemangsalternativ som är tillgängliga beror på ditt GitHub Copilot konto och den valda modellen:

    ? Select AI model
    ? Select reasoning effort level
    
  6. Beskriv vad du vill skapa. Inkludera relevanta krav, till exempel:

    • Om mallen innehåller programkod, endast infrastruktur eller båda.
    • Programspråken och ramverken, om de är kända.
    • De Azure tjänster och värdplattform som ska användas.
    • Om du vill använda Bicep eller Terraform.
    • Säkerhet, nätverk, skalning och regionkrav.

    Ett exempel:

    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. Svara på arkitektur- eller konfigurationsfrågor från Copilot. Agenten förbereder projektet för Azure, genererar malltillgångarna och kör fördistributionsverifiering.

  8. Granska den övergripande strukturen för de filer som Copilot skapat eller ändrat. Bekräfta att mallen innehåller den förväntade projektkonfigurationen, infrastrukturkatalogen, programkällan och stödtillgångarna för din lösning.

    En genererad mall för endast infrastruktur kan till exempel innehålla följande nyckelfiler:

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

    Detaljerad vägledning om hur du granskar konfigurations- och infrastrukturinnehållet finns i Utforska och redigera mallfiler.

Etablera och distribuera mallen

När du har godkänt de genererade filerna kör du följande kommando:

azd up

Kommandot skapar eller väljer en azd miljö, etablerar Azure resurser, paketar alla programtjänster och distribuerar dem. En detaljerad kommandouppdelning finns i azd up Utforska arbetsflödet.

Använda en annan redigeringsmetod

Andra AI-kodningsassistenter är inte direkt anslutna azd init till arbetsflödet, men de kan skapa samma standardmalltillgångar. Du kan också skapa alla tillgångar direkt.

Skapa dessa tillgångar själv eller be en annan kodningsassistent att analysera dina krav och skapa dem:

  • En azure.yaml fil som definierar projektet och distribuerade tjänster.
  • Bicep- eller Terraform-filer som etablerar de nödvändiga Azure-resurserna.
  • Resursutdata och programmiljövariabler.
  • Dockerfiles, distributionskonfiguration och stödskript vid behov.

Om du vill ange en minimal startpunkt innan du använder en annan agent kör du:

azd init --minimal

Om du använder en annan kodningsassistent instruerar du den azure.yamlatt följa schemat, Azure säkerhetsrutiner för infrastrukturen och mallkonventionerna som beskrivs i Azure CLI-mallar för utvecklare. Om du skapar filerna direkt använder du samma referenser som implementeringsguiden. Granska och verifiera alla filer innan du kör azd up.

Begär hjälp

Information om hur du skickar in en bugg, begär hjälp eller föreslår en ny funktion för Azure Developer CLI finns på sidan troubleshooting and support.