Översikt över att skapa CLI-mallar för Azure Developer

Azure Developer CLI (azd) använder mallar för att etablera och distribuera appresurser till molnet. Utvecklare kan lägga till stöd för azd kommandon och funktioner genom att konvertera sina program till mallar. Den här artikeln innehåller en sammanhangsbaserad översikt över de olika alternativen för att skapa azd mallar. När du förstår begreppen i den här artikeln går du till följande resurser för mer detaljerade implementeringsguider:

• Använd en befintlig mall för din app.
• Skapa en mall från din appkod
• Utbildning – skapa och distribuera azd mallar

Kommentar

Den här artikeln förutsätter en allmän förståelse av azd mallar. Mer information om mallar finns i mallöversiktsdokumentet .

Begrepp för att skapa mallar

Om du skapar en azd mall måste du lägga till specifika konfigurations- och infrastrukturtillgångar i din befintliga kodbas eller starta en ny app från en befintlig mall med samma tillgångar. Båda arbetsflödena förklaras i senare avsnitt. Alla azd mallar delar en liknande filstruktur baserat på azd konventioner. Följande diagram ger en snabb översikt över processen för att skapa en azd mall:

Varje azd mall kräver följande minsta resurser:

• En infra mapp som innehåller infrastrukturen som kodfiler (Bicep eller Terraform).
• En azure.yaml konfigurationsfil som mappar dina programtjänster till de etablerade infrastrukturresurserna.

Andra valfria kataloger ingår ofta också, till exempel en .github mapp med tillgångar för att skapa en CI/CD-pipeline. Mer information om mallar finns i mallöversiktsdokumentet .

Överväg följande exempelapplagringsplats:

När du har konverterat den här exempelappen till en azd mall innehåller samma applagringsplats följande:

De ursprungliga appresurserna är oförändrade, men nya tillgångar har lagts till som azd är beroende av kommandon som azd up:

• En infra mapp har lagts till som innehåller Bicep-filer för att skapa Azure-resurser.
• En azure.yaml konfigurationsfil lades till för att mappa appkoden i src katalogen till etableringen av Azure-resurser.
• En .azure mapp skapades för att lagra azd miljövariabler.
• En .github mapp (valfritt) har lagts till för att stödja CI/CD-pipelines via GitHub-åtgärder.

Arbetsflöden för att skapa mallar

Kommandot azd init används för att initiera en azd mall för etablering och distribution av appresurser i Azure. Kommandot uppmanar dig att välja mellan två olika arbetsflöden för att initiera en mall som beskrivs i följande avsnitt – Använd kod i den aktuella katalogen och Använd en befintlig mall.

azd init Kör kommandot i roten för den katalog som du vill konvertera till :azd template

azd init

Använda kod i den aktuella katalogen

Det här alternativet instruerar azd att analysera koden i din katalog till identitet vilka tekniker den använder, till exempel programmeringsspråk, ramverk och databassystem. azd genererar automatiskt malltillgångar åt dig, till exempel tjänstdefinitionsfilen azure.yaml och infra mappen med infrastruktur-som-kod-filer. De genererade tillgångarna är en startpunkt för ytterligare ändringar. Använd den här metoden om du planerar att använda vanliga Azure-tjänster som stöds av azd funktionsställningar.

Gå till självstudiekursen Börja med din appkod för att skapa en mall för mer information om hur du implementerar den här metoden och mer information om vilka Azure-resurser som stöder automatisk identifiering och scaffolding.

Välj en mall

Välj det här alternativet om du vill använda en befintlig mall som definierar många av dina Azure-resurser och arkitekturmål som utgångspunkt. azd uppmanar dig att välja en startmall eller en annan mall från galleriet awesome-azd . När du väljer en mall läggs mallens tillgångar till i den befintliga projektkatalogen som ska användas som utgångspunkt. Vissa mallar innehåller exempelappkod som du kan ersätta med din egen, medan vissa (som kallas "startmallar") endast är infrastruktur.

azd init Använd kommandot för att hämta en befintlig mall till en tom katalog och använda den som utgångspunkt för din egen app. Om mallen innehåller källkod för appen kan du antingen bygga bort koden eller ersätta källkodskatalogen med din egen.

Gå till självstudiekursen Börja med en befintlig mall för mer information om hur du implementerar den här metoden.

Se även

• Använd en befintlig mall för din app.
• Skapa en mall från din appkod

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å felsöknings - och supportsidan .

Nästa steg

Vanliga frågor om Azure Developer CLI