Dela via


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:

  • Använd kod i 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.

Använd kod i den nuvarande katalogen

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 Använd kod i den aktuella katalogen. 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? Use code in the 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:

    azd init
    

    Anmärkning

    Du kan också köra azd init med parametern --minimal för att hoppa över arbetsflödesvalet.

  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.
    

    Endast den grundläggande azure.yaml konfigurationsfilen skapas. Ingen programkod eller omfattande infrastrukturmallar läggs till, så du måste skapa eller anpassa infrastrukturfilerna manuellt baserat på dina krav.

  3. Du kan använda azd addkomponeringsfunktionen för att börja lägga till Azure-resurser i din app.

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.