Utforska azure developer CLI-initieringsarbetsflöden

Azure Developer CLI (azd) innehåller en uppsättning kommandon för att effektivisera utvecklingen, etableringen och distributionen av appen i Azure. Kommandot azd init hjälper dig att konfigurera nya eller befintliga projekt genom att generera de filer och konfigurationer som behövs för att arbeta med azd. Den här artikeln beskriver de olika tillgängliga initieringsarbetsflödena och hur du väljer det bästa alternativet för ditt utvecklingsscenario.

Initieringsarbetsflöden

Kommandot azd init har stöd för flera arbetsflöden för att förbereda appen för att fungera med azd:

• Sök igenom den aktuella katalogen: Analyserar en befintlig appkodbas för att generera lämpliga azd konfigurationsfiler och resurser.
• Välj en mall: Klonar och initierar en mall från ett azdmallgalleri.
• Skapa ett minimalt projekt: Initierar en grundläggande azure.yaml fil som utgångspunkt för att skapa en egen azd mall från grunden.

Välj den metod som passar ditt projekt bäst. Alla dessa flöden beskrivs mer detaljerat i översikten skapa mallar och relaterade artiklar. Följande avsnitt innehåller en konceptuell översikt över varje flöde.

Sök igenom aktuell katalog

Använd det här arbetsflödet när du har en befintlig appkodbas och vill förbereda den för distribution till Azure med hjälp av azd.

1. Gå till projektets rotkatalog.

2. azd init Kör kommandot:

   azd init
   

3. Välj Sök igenom aktuell katalog. azd ska:

   • Genomsök din katalog för att fastställa vilket språk eller ramverk din app använder.
   • Välj en lämplig värdplattform, till exempel Azure Container Apps.
   • Uppmana dig att lägga till eller ta bort identifierade tjänster om det behövs.

   ? 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. Välj Bekräfta och fortsätt initiera min app för att slutföra arbetsflödet. azd skapar följande i appkatalogen:

   • En azure.yaml fil som definierar dina apptjänster och mappar dem till värdresurser.
   • En .azure mapp som innehåller konfigurationsinställningar, till exempel ditt miljönamn.
   • En .gitignore fil som har konfigurerats för ditt appspråk och värdplattform.

5. Du kan också köra azd up för att skapa Azure Container Apps-resurser och distribuera din app.

Din app är nu strukturerad som en azd mall som du kan fortsätta att utveckla och expandera med fler Azure-resurser och -tjänster.

Välj en mall

Med det här arbetsflödet kan du börja med en fördefinierad azd mall som vanligtvis innehåller både programkod och nödvändiga Azure-infrastrukturdefinitioner.

1. azd init Kör kommandot:

   azd init
   

   Anmärkning

   Du kan också köra azd init med parametern --template för att direkt initiera en mall efter namn och hoppa över arbetsflödesvalet.

2. Välj Välj en mall. azd visar en lista över tillgängliga mallar från dina konfigurerade mallkällor.

   ? 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. Skriv för att filtrera resultaten och sök efter mallen Hello AZD . Tryck på Retur för att klona och initiera mallen.

4. Du kan också köra azd up för att etablera och distribuera mallresurserna till Azure.

Du kan också använda den initierade mallen som utgångspunkt för vidare utveckling.

Skapa ett minimalt projekt

För avancerade användare som vill börja med en minimal konfiguration och anpassa allt manuellt ger det här alternativet bara den grundläggande konfigurationen.

1. azd init Kör kommandot med --minimal flaggan:

   azd init --minimal
   

2. När du uppmanas till det anger du ett namn för mallen azd och trycker på Retur.

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

   Flaggan --minimal skapar bara följande:

   • En grundläggande azure.yaml fil med bara projektnamnet och schemaVersion
   • En .azure katalog för miljökonfiguration
   • En .gitignore fil som innehåller korrekta poster för Azure Developer CLI

   Den här effektiva initieringen är perfekt när du:

   • Vill du skapa din infrastruktur från grunden
   • Behöver integreras azd med ett befintligt komplext projekt
   • Planera att använda azd add kommandot för att stegvis skapa din arkitektur
   • Föredra att ha full kontroll över din projektstruktur

3. Efter initieringen kan du:

   • Skapa infrastrukturfilerna manuellt i en infra mapp
   • azd add Använd skrivfunktionen för att börja lägga till Azure-resurser i din app
   • Anpassa filen azure.yaml för att definiera dina tjänster och resurser

Namngivning av projekt- och Azure-resurser

När du initierar ett nytt eller befintligt projekt anges projektnamnet i azure.yaml. Projektnamnet fungerar som ett prefix för Azure-resursnamn som skapades under etableringsprocessen. Genom att följa verifieringsreglerna ser du till att även genererade Azure-resursnamn är giltiga.

I Bicep- eller Terraform-mallar används projektnamnet ofta som bas för att konstruera resursnamn, kombinerat med miljönamnet och andra element. Till exempel:

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

Var name refererar till projektnamnet och environmentName är namnet på din azd miljö.

Verifieringsregler för projektnamn

När du använder azd init för att initiera ett projekt eller när du skapar ett nytt projektnamn i azure.yaml filen tillämpas följande verifieringsregler:

Dessa verifieringsregler säkerställer att projektnamnet är kompatibelt med namngivningskraven för Azure-resurser och förhindrar fel med tjänstpaketering under distributionen.

Nästa steg

När du har initierat projektet med azd initkan du:

• Ändra de genererade infrastrukturfilerna för att anpassa dina Azure-resurser.
• Använd azd provision för att skapa nödvändiga resurser i Azure.
• Använd azd deploy för att distribuera programkoden till de etablerade resurserna.
• Lär dig mer om azure developer CLI up-arbetsflödet för att kombinera etablering och distribution i ett enda kommando.

Relaterat innehåll

• Cli-kommandon för Azure Developer
• Schemareferens för Azure.yaml
• Azure Developer CLI-mallar
• Mallgallerier