översikt över mallutveckling för Azure Developer CLI (azd)

Azure CLI-mallar för utvecklare (azd) paketera konfiguration, infrastruktur och valfri programkod som krävs för att etablera och distribuera en lösning på Azure. Du kan använda en mall för ett program, ett infrastrukturprojekt eller en återanvändbar startpunkt för framtida projekt.

Note

Innan du börjar kan du läsa Azure CLI-mallar för utvecklare för en fullständig beskrivning av mallstrukturen, nödvändiga och valfria tillgångar, service-till-resurs-associationer och hur azd kommandon använder varje fil.

Arbetsflöde för mallutveckling

Följande arbetsflöde gäller oavsett om du skapar en mall eller initierar en som redan finns:

Diagram över arbetsflödet för utveckling av CLI-mallar för Azure utvecklare. Till vänster innehåller en ruta med etiketten "Välj en startpunkt" två alternativ: "Börja med en ny mall" och "Starta från en befintlig mall". Båda alternativen leder till "Utforska och redigera mallfilerna". Därifrån leder en valfri sökväg till "Utöka mallen" och huvudsökvägen fortsätter till "Kör azd up". Steget "Utöka mallen" leder också till "Kör azd up". Slutligen leder "Kör azd up" till "Underhåll eller dela mallen".

• Välj en startpunkt:Börja med en ny mall med GitHub Copilot integrering, en annan AI-kodningsassistent eller direktredigering. Du kan också börja från en befintlig mall från Microsoft, din organisation eller utvecklarcommunityn.
• Utforska och redigera filerna: Granska hur azure.yaml, Bicep- eller Terraform-filer, appkod och stödkonfiguration fungerar tillsammans. Se Utforska och redigera mallfiler.
• Utöka och utveckla efter behov: Lägg till, ersätt, ta bort eller omdesigna app- och infrastrukturkomponenter. Se Utöka en mall för ett komplett exempel som lägger till en Azure-resurs och ansluter den till en app.
• Etablera och distribuera: Kör azd up för att etablera infrastrukturen och distribuera apptjänster. Mer information finns i azd up Utforska arbetsflödet.
• Underhålla eller dela: Fortsätt att redigera mallen allt eftersom projektet utvecklas. Om du planerar att dela den, testa den först i en ren katalog och med en ny azd-miljö.

Note

I det här arbetsflödet kan du skapa, redigera eller ersätta mallfiler själv eller med hjälp av en AI-kodningsassistent. Resultatet är samma uppsättning av standard, redigerbara azd tillgångar.

Byggblock för mallar

Varje azd mall stöder en annan lösning, men de flesta mallar kombinerar samma typer av tillgångar:

• Projektkonfiguration:azure.yaml-filen identifierar projektet, driftsättningsbara tjänster, källkataloger, hostingmål samt valfria krokar eller arbetsflöden.
• Infrastruktur som kod: Bicep- eller Terraform-filer definierar de Azure resurser, rolltilldelningar, nätverk och appinställningar som krävs för lösningen.
• Programkälla: En mall kan innehålla en eller flera distribuerade appar, eller så kan den bara innehålla infrastruktur.
• Miljökonfiguration: Parametrar skickar miljöspecifika värden till distributioner och infrastrukturutdata blir värden i den aktiva azd miljön.

En mall för en app kan använda följande mappstruktur:

.
├── azure.yaml                # Project configuration
├── infra/                    # Infrastructure as code
│   ├── main.bicep
│   ├── main.parameters.json
│   └── modules/
├── src/                      # Application source
│   ├── api/
│   └── web/
├── .github/                  # Pipeline workflows
│   └── workflows/
└── README.md

Den exakta strukturen varierar beroende på projekt. Appkälla, infrastrukturmoduler och pipelinefiler är valfria och azure.yaml identifierar de sökvägar som azd används. Dessa tillgångar fungerar tillsammans under hela mallutvecklingslivscykeln.

Nästa steg

Börja med en ny mall

Begär hjälp

Information om hur du skickar in en bugg, begär hjälp eller föreslår en ny funktion för Azure Developer CLI finns på sidan troubleshooting and support.