Beginnen met een nieuwe Azure Developer CLI-sjabloon (azd)

U kunt verschillende ontwerpmethoden gebruiken om de standaardbestanden te bouwen in een nieuwe Azure Developer CLI(azd)-sjabloon:

  • Gebruik de GitHub Copilot-integratie in azd init. De ingebouwde werkstroom analyseert bestaande projectbestanden of helpt u bij het plannen van een nieuw project, het maken van de sjabloonassets en het uitvoeren van predeploymentvalidatie.
  • Gebruik een andere AI-coderingsassistent. Vraag de assistent om dezelfde azure.yaml, infrastructuur-als-code, applicatie en ondersteunende bestanden te maken zonder rechtstreeks met azd init te integreren.
  • Bewerk de bestanden rechtstreeks. Maak en bewerk zelf de sjabloonassets als u volledige controle wilt of geen AI-coderingsassistent wilt gebruiken.

Dit artikel richt zich voornamelijk op de ingebouwde GitHub Copilot-werkstroom, omdat het een begeleide ervaring biedt die is geïntegreerd met azd. Ongeacht de ontwerpmethode controleert en valideert u elk bestand vóór de implementatie.

Important

De GitHub Copilot-integratie in azd init is in preview. Preview-functies kunnen vóór algemene beschikbaarheid worden gewijzigd. Zie de azd strategie voor functieversiebeheer en release voor meer informatie.

De gegenereerde assets zijn standaard, bewerkbare azd sjabloonbestanden. Na de initialisatie kunt u ze rechtstreeks of met elke AI-coderingsassistent bijwerken.

Vereisten voor GitHub Copilot

Als u de ingebouwde Copilot-werkstroom wilt gebruiken, hebt u het volgende nodig:

  • Azure Developer CLI 1.23.11 of hoger.
  • Een actief GitHub Copilot-abonnement.
  • Git, dat azd init gebruikt om de werkmap te inspecteren voordat bestanden worden gewijzigd.
  • Een interactieve terminalsessie.

Als u nog niet bent geverifieerd met GitHub Copilot, azd wordt u gevraagd u aan te melden.

Voer deze opdracht uit azd version om de geïnstalleerde Azure Developer CLI-versie te controleren.

Note

De azd init werkstroom start een toegewezen GitHub Copilot-agent sessie in de terminal. Er wordt geen actieve GitHub-Copilot Chat-sessie in Visual Studio Code gebruikt of voortgezet.

Bouwen met GitHub Copilot

  1. Open een terminal in de map waarin u de sjabloon wilt maken.

    Note

    De map kan een bestaande toepassing, een infrastructuurproject of de eerste bestanden voor een nieuwe oplossing bevatten. Als de map niet-doorgevoerde wijzigingen bevat, azd wordt u gevraagd om te bevestigen voordat u doorgaat. Belangrijke wijzigingen eerst doorvoeren of opslaan.

  2. Voer azd init uit:

    azd init
    
  3. Selecteer Instellen met GitHub Copilot (voorbeeld).

    De initialisatieprompt lijkt op het volgende voorbeeld:

    ? How do you want to initialize your app?
       Scan current directory
       Select a template
    > Set up with GitHub Copilot (Preview)
    
  4. Controleer de aangevraagde toegang tot de tools en verleen toegang tot de tools die vereist zijn voor de workflow. Copilot maakt gebruik azd van en Azure ontwikkelmogelijkheden om het project te controleren, bestanden te maken en het resultaat te valideren.

  5. Selecteer een model en redeneringsniveau als azd u wordt gevraagd deze te configureren.

    Bij de eerste uitvoering gebruiken de prompts de volgende labels. De beschikbare model- en redeneringskeuzen zijn afhankelijk van uw GitHub Copilot-account en het geselecteerde model:

    ? Select AI model
    ? Select reasoning effort level
    
  6. Beschrijf wat u wilt bouwen. Neem relevante vereisten op, zoals:

    • Of de sjabloon nu alleen toepassingscode, infrastructuur of beide bevat.
    • De toepassingstalen en frameworks, indien bekend.
    • De Azure-services en het hostingplatform die moeten worden gebruikt.
    • Of u nu Bicep of Terraform wilt gebruiken.
    • Vereisten voor beveiliging, netwerken, schalen en regio's.

    Voorbeeld:

    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. Beantwoord vragen over architectuur of configuratie van Copilot. De agent bereidt het project voor op Azure, genereert de sjabloonassets en voert predeploymentvalidatie uit.

  8. Bekijk de algehele structuur van de bestanden die Copilot gemaakt of gewijzigd. Controleer of de sjabloon de verwachte projectconfiguratie, infrastructuurmap, toepassingsbron en ondersteunende assets voor uw oplossing bevat.

    Een gegenereerde sjabloon voor alleen infrastructuur kan bijvoorbeeld de volgende sleutelbestanden bevatten:

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

    Zie Sjabloonbestanden verkennen en bewerken voor gedetailleerde richtlijnen voor het controleren van de inhoud van de configuratie en infrastructuur.

De sjabloon inrichten en implementeren

Nadat u de gegenereerde bestanden hebt goedgekeurd, voert u de volgende opdracht uit:

azd up

De opdracht maakt of selecteert een azd omgeving, richt de Azure resources in, verpakt alle toepassingsservices en implementeert deze. Zie De werkstroom verkennen voor een gedetailleerde uitsplitsing van opdrachtenazd up.

Een andere ontwerpmethode gebruiken

Andere AI-coderingsassistenten zijn niet rechtstreeks verbonden met de azd init werkstroom, maar ze kunnen dezelfde standaardsjabloonassets maken. U kunt ook elke asset rechtstreeks schrijven.

Maak deze assets zelf of vraag een andere coderingsassistent om uw vereisten te analyseren en deze te maken:

  • Een azure.yaml bestand dat het project definieert en implementeerbare services.
  • Bicep- of Terraform-bestanden waarmee de vereiste Azure-resources worden geïmplementeerd.
  • Resource-uitvoer en omgevingsvariabelen voor toepassingen.
  • Dockerfiles, implementatieconfiguratie en ondersteunende scripts indien nodig.

Als u een minimaal beginpunt wilt bieden voordat u een andere agent gebruikt, voert u het volgende uit:

azd init --minimal

Als u een andere coderingsassistent gebruikt, geeft u deze opdracht om het azure.yaml schema te volgen, Azure beveiligingsprocedures voor infrastructuur en de sjabloonconventies die worden beschreven in Azure Cli-sjablonen voor ontwikkelaars. Als u de bestanden rechtstreeks ontwerpt, gebruikt u dezelfde verwijzingen als uw implementatiehandleiding. Controleer en valideer alle bestanden voordat u deze uitvoert azd up.

Hulp vragen

Ga naar de pagina roubleshooting en ondersteuning voor informatie over het indienen van een bug, hulp vragen of een nieuwe functie voorstellen voor de Azure Developer CLI.