Delen via

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:

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

Kies de methode die het beste past bij uw project. Al deze stromen worden uitgebreid beschreven in het overzicht van sjablonen maken en gerelateerde artikelen. De volgende secties bieden een conceptueel overzicht van elke stroom.

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.

  1. Navigeer naar de hoofdmap van uw project.

  2. Voer de azd init opdracht uit:

    azd init

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

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

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

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

  2. 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)

  3. Typ om de resultaten te filteren en naar de Hello AZD sjabloon te zoeken. Druk op Enter om de sjabloon te klonen en te initialiseren.

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

  1. Voer de azd init opdracht uit met de --minimal vlag:

    azd init --minimal

  2. Wanneer u hierom wordt gevraagd, voert u een naam voor de azd sjabloon in en drukt u op 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.

    Met de --minimal vlag wordt alleen het volgende gemaakt:

    • Een basisbestand azure.yaml met alleen de projectnaam en schemaVersion
    • 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
    • Plan om de azd add opdracht te gebruiken om uw architectuur incrementeel te bouwen
    • Geef de voorkeur aan volledige controle over uw projectstructuur

  3. Na de initialisatie kunt u het volgende doen:

    • Maak uw infrastructuurbestanden handmatig in een infra map
    • azd add De functie Opstellen gebruiken om Azure-resources toe te voegen aan uw app
    • Uw azure.yaml bestand aanpassen 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.

Verwante inhoud

  • Last updated on