Så här fungerar Azure Developer CLI

Slutförd

Azure Developer CLI (azd) bygger på utvecklarvänliga kommandon och grundläggande programmallar. azd innehåller en uppsättning kommandon som hjälper dig att registrera och hantera ditt program i Azure med hjälp av standardiserade projektmallar. Dessa mallar innehåller alla nödvändiga källkods- och konfigurationstillgångar för att etablera och distribuera din app till Azure. Du kan börja använda azd genom att antingen arbeta bort en av de befintliga och utökningsbara exempelmallarna eller genom att skapa en egen.

Utforska azd kommandon

Azure Developer CLI innehåller en lättillgänglig uppsättning kommandon som mappar till vanliga steg i arbetsflödet för utveckling, till exempel etablering och distribution av resurser. Vissa azd kommandon, till exempel azd up hanterar flera steg samtidigt för att ytterligare effektivisera dessa uppgifter.

Ett vanligt azd arbetsflöde med hjälp av en befintlig mall innehåller till exempel följande steg:

1. azd init Kör kommandot med parametern --template för att klona en befintlig mall och ange ett miljönamn när du uppmanas att göra det.

   azd init --template todo-nodejs-mongo
   

2. azd auth login Kör kommandot för att logga in på din Azure-prenumeration.

   azd auth login
   

3. azd up Kör kommandot för att etablera och distribuera mallresurserna till Azure.

   azd up
   

4. När din miljö har konfigurerats i Azure kan du lokalt ändra programfunktionerna eller Azure-resursmallarna och sedan köra azd up igen för att etablera dina ändringar.

Andra azd kommandon är tillgängliga för att slutföra andra uppgifter och expandera det här arbetsflödet. azd är utformad för att ha ett minimalt antal kommandon med få parametrar för enkel användning. Några av de vanligaste azd kommandona är:

• azd init – Initiera ett nytt program.
• azd up – Etablera Azure-resurser och distribuera projektet med ett enda kommando.
• azd provision – Etablera Azure-resurserna för ett program.
• azd deploy – Distribuera programkoden till Azure.
• azd pipeline – (Beta) Hantera och konfigurera dina distributionspipelines.
• azd auth – Autentisera med Azure.
• azd config – Hantera azd-konfigurationer (till exempel azure-standardprenumeration, plats).
• azd down – Ta bort Azure-resurser för ett program.

Utforska azd mallar

Azure Developer CLI-kommandona är utformade för att fungera med standardiserade projektmallar. Varje mall är en kodlagringsplats som följer specifika fil- och mappkonventioner. Mallarna innehåller de tillgångar azd som krävs för att etablera Azure-resurser och eventuellt distribuera programkällans kod. Vissa mallar kanske inte innehåller programkällans kod under antagandet att du lägger till din egen. När du kör ett kommando som azd upanvänder verktyget projektmallens tillgångar för att köra olika arbetsflödessteg, till exempel etablering eller distribution av resurser till Azure.

Det finns två huvudsakliga metoder för att arbeta med azd mallar:

• Utöka en befintlig azd mall – Det finns redan ett stort bibliotek med azd mallar som täcker vanliga lokala programstackar, scenarier och arkitekturer. Du kan bläddra bland många av mallarna på webbplatsen för mallbiblioteket awesome-azd. Om du hittar en mall som mappar till din lokala programstack eller önskad arkitektur kan du använda den som utgångspunkt. Ersätt sedan källkodskatalogen och ändra konfigurations- eller infrastrukturfilerna efter dina behov.

• Konvertera din egen app till en azd mall – Du kan också konvertera en befintlig app till en azd template genom att följa guiden Gör ditt projekt kompatibelt med azd . Att skapa en egen mall är ofta mer arbete från början, men ger mest kontroll och skapar en återanvändbar lösning för framtida utvecklingsarbete i appen. De viktigaste stegen för att skapa en egen mall är följande:

  • Initiera projektmallen med azd init.

  • Skapa infrastrukturen som kodfiler med Bicep eller Terraform.

  • azure.yaml Uppdatera filen för att koppla apptjänsterna till Azure-resurserna.

  • Etablera och distribuera med azd up.

    

Oavsett vilken metod du väljer är den resulterande mallstrukturen densamma. Alla azd mallar innehåller följande tillgångar:

• infra folder – Innehåller hela Bicep- eller Terraform-infrastrukturen som kodfiler för mallen azd . Med infrastruktur som kod kan du definiera infrastrukturresurser och konfigurationer i deklarativa definitionsfiler som på ett tillförlitligt sätt genererar samma miljöer varje gång de distribueras. Terraform fungerar på flera molnplattformar, medan Bicep är specifikt för Azure. azd kör dessa filer för att skapa de Azure-resurser som krävs för att vara värd för din app. Du kan lära dig mer om infrastruktur som kod i träningsmodulen Vad är infrastruktur som kod?

• azure.yaml file – En konfigurationsfil som definierar en eller flera tjänster i projektet och mappar dem till Azure-resurser för distribution. Du kan till exempel definiera en API-tjänst och en webbklientdelstjänst, var och en med attribut som mappar dem till olika Azure-resurser för distribution.

• .azure folder – Innehåller viktiga Azure-konfigurationer och miljövariabler, till exempel platsen för att distribuera resurser eller annan prenumerationsinformation.

• src folder – Innehåller all distributionsbar app-källkod. Vissa azd mallar tillhandahåller bara infrastrukturtillgångar och lämnar src katalogen tom så att du kan lägga till din egen programkod.

  

De flesta azd mallar kan också innehålla en eller flera av följande mappar:

• .devcontainer mapp – Gör att du kan konfigurera en Dev Container-miljö för ditt program. En vanlig metod för utvecklingsmiljön som inte är specifik för azd.
• .github folder – Innehåller CI/CD-arbetsflödesfilerna för GitHub Actions, ci/CD-standardprovidern för azd.
• .azdo mapp – Om du bestämmer dig för att använda Azure Pipelines för CI/CD definierar du arbetsflödeskonfigurationsfilerna i den här mappen.