De initialisatiewerkstromen van Azure Developer CLI verkennen

De Azure Developer CLI (azd) biedt een set opdrachten voor het stroomlijnen van het ontwikkelen, inrichten en implementeren van apps in Azure. Met de azd init opdracht kunt u nieuwe of bestaande projecten instellen door de bestanden en configuraties te genereren die nodig zijn om mee azdte werken. In dit artikel worden de verschillende beschikbare initialisatiewerkstromen uitgelegd en wordt uitgelegd hoe u de beste optie voor uw ontwikkelscenario selecteert.

Initialisatiewerkstromen

De azd init opdracht ondersteunt verschillende werkstromen om uw app voor te bereiden voor gebruik met azd:

Instellen met GitHub Copilot (voorbeeld): hiermee start u een toegewezen Copilot-agent sessie waarmee u een project kunt plannen, sjabloonassets kunt genereren en het resultaat kunt valideren.
Huidige map scannen: analyseert een bestaande app-codebasis om de juiste azd configuratiebestanden en -resources te genereren.
Selecteer een sjabloon: Kloont en initialiseert een sjabloon in een azdsjabloongalerie.
Een minimaal project maken: initialiseert een basisbestand azure.yaml als uitgangspunt voor het bouwen van uw eigen azd sjabloon.

Voor sjabloonontwikkeling gebruikt u Instellen met GitHub Copilot (voorbeeld). Zie het overzicht van sjabloonontwikkeling voor een overzicht van de volledige ontwerplevenscyclus. In de volgende secties wordt elke initialisatiewerkstroom beschreven.

Instellen met GitHub-Copilot (voorbeeld)

Gebruik deze werkstroom om een sjabloon te bouwen met AI-hulp. azdstart een toegewezen GitHub-Copilot-agent sessie waarmee bestaande projectbestanden kunnen worden gecontroleerd of waarmee u een nieuw project kunt plannen. De agent genereert standaardassetsazd, zoals azure.yamlBicep- of Terraform-bestanden en containerconfiguratie, en valideert vervolgens het resultaat.

De agentsessie wordt uitgevoerd in de terminal en gaat niet verder met een actieve GitHub-Copilot Chat sessie vanuit Visual Studio Code. Zie Beginnen met een nieuwe sjabloon voor vereisten en gedetailleerde instructies.

Huidige map scannen

Gebruik deze werkstroom wanneer u een bestaande app-codebasis hebt en deze wilt voorbereiden op implementatie in Azure met behulp van azd.

Navigeer naar de hoofdmap van uw project.
Voer de azd init opdracht uit.
```
azd init
```

Selecteer Scan huidige map. azd wil:

Scan uw directory om de taal of het framework te bepalen dat uw app gebruikt.
Selecteer een geschikt hostingplatform, zoals Azure Container Apps.
U wordt gevraagd om indien nodig gedetecteerde services toe te voegen of te verwijderen.

? 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

Selecteer Bevestigen en ga verder met het initialiseren van mijn app om de werkstroom te voltooien. azd maakt het volgende in uw app-directory:
- Een azure.yaml bestand dat uw appservices definieert en deze toewijst aan hostingbronnen.
- Een .azure map met configuratie-instellingen, zoals de naam van uw omgeving.
- Een .gitignore bestand dat is geconfigureerd voor uw app-taal en hostingplatform.
Desgewenst kunt u azd up gebruiken om de Azure Container Apps-resources te creëren en uw app te implementeren.

Uw app is nu gestructureerd als sjabloon azd die u kunt blijven ontwikkelen en uitbreiden met meer Azure-resources en -services.

Een sjabloon selecteren

Met deze werkstroom kunt u beginnen met een vooraf samengestelde azd sjabloon die meestal zowel toepassingscode als de benodigde Azure-infrastructuurdefinities bevat.

Voer de azd init opdracht uit:
```
azd init
```
Opmerking

U kunt ook azd init uitvoeren met de --template parameter om een sjabloon rechtstreeks op naam te initialiseren en de selectie van de werkstroom over te slaan.

Kies Een sjabloon selecteren. azd geeft een lijst weer met beschikbare sjablonen uit de geconfigureerde sjabloonbronnen.

? 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)

Typ om de resultaten te filteren en naar de Hello AZD sjabloon te zoeken. Selecteer de sjabloon die u wilt klonen en initialiseren.
U kunt desgewenst azd up uitvoeren om de sjabloonbronnen in Azure te voorzien en implementeren.

U kunt de geïnitialiseerde sjabloon ook gebruiken als uitgangspunt voor verdere ontwikkeling.

Een minimaal project maken

Voor geavanceerde gebruikers die willen beginnen met een minimale installatie en alles handmatig aanpassen, biedt deze optie alleen de essentiële configuratie.

Voer de azd init opdracht uit met de --minimal vlag:
```
azd init --minimal
```
Wanneer u hierom wordt gevraagd, voert u een naam voor de azd sjabloon in en selecteert u 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.
```
Met de --minimal vlag wordt alleen het volgende gemaakt:
- Een basisbestand azure.yaml met de projectnaam
- Een .azure map voor omgevingsconfiguratie
- Een .gitignore bestand met de juiste vermeldingen voor Azure Developer CLI
Deze gestroomlijnde initialisatie is ideaal wanneer u:
- Wilt u uw infrastructuur helemaal opnieuw bouwen
- Moet worden geïntegreerd azd met een bestaand complex project
- Geef de voorkeur aan volledige controle over uw projectstructuur
Voltooi de projectconfiguratie. U kunt handmatig infrastructuurbestanden in een infra map maken, een AI-coderingsagent vragen om de infrastructuur te maken en aanpassen azure.yaml om uw services en resources te definiëren.

Naamgeving van project- en Azure-resources

Wanneer u een nieuw of bestaand project initialiseert, wordt de projectnaam ingesteld in azure.yaml. De projectnaam fungeert als een voorvoegsel voor Azure-resourcenamen die tijdens het inrichtingsproces zijn gemaakt. Door de validatieregels te volgen, zorgt u ervoor dat gegenereerde Azure-resourcenamen ook geldig zijn.

In Bicep- of Terraform-sjablonen wordt de projectnaam vaak gebruikt als basis voor het samenstellen van resourcenamen, gecombineerd met de omgevingsnaam en andere elementen. Voorbeeld:

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

Waar name wordt verwezen naar de projectnaam en environmentName de naam van uw azd omgeving.

Validatieregels voor projectnamen

Wanneer u azd init gebruikt om een project te initialiseren of een nieuwe projectnaam aan te maken in het azure.yaml bestand, worden de volgende validatieregels toegepast:

Regel	Description
Toegestane tekens	Projectnamen kunnen alleen kleine letters, cijfers en afbreekstreepjes bevatten.
Startkarakter	Projectnamen moeten beginnen met een letter.
Eindkarakter	Projectnamen mogen niet eindigen met een afbreekstreepje.
Lengte	Projectnamen moeten tussen de 2 en 63 tekens lang zijn.
Geen opeenvolgende afbreekstreepjes	Projectnamen mogen geen opeenvolgende afbreekstreepjes bevatten.

Deze validatieregels zorgen ervoor dat de naam van uw project compatibel is met de naamgevingsvereisten van Azure-resources en ervoor zorgt dat serviceverpakkingsfouten tijdens de implementatie worden voorkomen.

Volgende stappen

Nadat u azd init uw project hebt geïnitialiseerd, kunt u het volgende doen:

Wijzig de gegenereerde infrastructuurbestanden om uw Azure-resources aan te passen.
Gebruik azd provision om de vereiste resources in Azure te maken.
Gebruik azd deploy om uw toepassingscode te implementeren op de ingerichte resources.
Meer informatie over de Azure Developer CLI-werkstroom voor het combineren van inrichting en implementatie in één opdracht.

Feedback

Is deze pagina nuttig?

Last updated on 2026-09-16