Dela via

Konfigurera och använda mallkällor

Azure Developer CLI är utformat kring ett kraftfullt mallsystem som effektiviserar distribution och etablering av Azure-resurser. När du utvecklar med azdkan du antingen skapa en egen mall eller välja från en konfigurerbar lista över befintliga mallar. I den här artikeln får du lära dig hur du arbetar med malllistor och konfigurerar din lokala azd installation för att stödja olika malllistkällor.

Förstå mallkällor

En azd mallkälla pekar på en JSON-konfigurationsfil som beskriver en lista över tillgängliga mallar och deras viktiga metadata, till exempel namn, beskrivning och plats för mallens källkod (vanligtvis en GitHub-lagringsplats). När du aktiverar en mallkälla görs de mallar som definieras tillgängliga via azd andra kommandon. Till exempel definierar JSON-kodfragmentet för mallkällan nedan två mallar:

[
  {
    "name": "Starter - Bicep",
    "description": "A starter template with Bicep as infrastructure provider",
    "repositoryPath": "azd-starter-bicep",
    "tags": ["bicep"]
  },
  {
    "name": "Starter - Terraform",
    "description": "A starter template with Terraform as infrastructure provider",
    "repositoryPath": "azd-starter-terraform",
    "tags": ["terraform"]
  }
]

Varje mallpost i JSON-konfigurationsfilen innehåller följande egenskaper:

  • namn: Mallens visningsnamn.
  • beskrivning: En kort sammanfattning av vad mallen gör.
  • repositoryPath: Sökvägen till mallens källkod, som kan vara:
    • En fullständigt kvalificerad URI till en Git-lagringsplats, till exempel "https://dev.azure.com/org/project/_git/repo".
    • "{owner}/{repo}" för GitHub-lagringsplatser.
    • "{repo}" för GitHub-lagringsplatser under Azure-Samples organisation.
  • taggar: Nyckelord som hjälper användare att filtrera mallar med azd init --filter <tag> och azd template list --filter <tag>.

Ett fullständigt exempel finns i den här JSON-filen, som är standardmallkällan som ingår i azd.

azd gör att du kan aktivera flera mallkällor åt gången. Följande källalternativ för mallar är för närvarande tillgängliga att välja mellan:

  • awesome-azd – En lista över mallarna från Awesome AZD-galleriet som är aktiverat som standard.
  • default – en liten uppsättning kuraterade mallar för att demonstrera olika tekniska stackar.
  • file – En lokal sökväg/nätverkssökväg som pekar på en JSON-konfigurationsfil för mallkällan.
  • url – En adresserbar HTTP(S) sökväg som pekar på en JSON-konfigurationsfil för mallkällan.
  • gh – Pekar på en GitHub-lagringsplats.
  • ade – pekar på en malllista för Azure Deployment Environment. Läs mer om CLI-stöd för Azure Developer för Azure-distributionsmiljöer.

Arbeta med mallkällor

azd innehåller flera kommandon för att konfigurera mallkällor.

azd template source list Använd kommandot för att visa en lista över alla för närvarande konfigurerade mallkällor:

azd template source list

Exempel på utdata med två konfigurerade mallkällor:

Key          Name         Type         Location

awesome-azd  Awesome AZD  awesome-azd  https://aka.ms/awesome-azd/templates.json
default      Default      resource

azd template source add Använd kommandot för att lägga till en ny mallkälla. Det här kommandot accepterar följande parametrar:

  • nyckel: Mallkällans tekniska namn.
  • --type, -t: Mallkällans typ – giltiga värden är fil, URL och gh för GitHub.
  • --location, -l: Mallkällans plats, som ska vara ett lokalt nätverk eller HTTP(S) webb-URI.
  • --name, -n: Mallkällans visningsnamn (valfritt, använder nyckel om det utelämnas).
azd template source add <key> --type <file-or-url-or-gh> --location <your-uri> --name <your-display-name>

azd template source remove Använd kommandot för att ta bort en mallkälla:

azd template source remove <key>

azd config reset Använd kommandot för att återställa mallkonfigurationen till standardinställningarna:

azd config reset

Arbeta med malllistor

När du har konfigurerat mallkällorna azd template list använder du kommandot för att visa en lista över tillgängliga mallar från dessa källor:

azd template list

En standardinstallation av azd visar till exempel följande mallar från mallkällan awesome-azd :

Name                                                         Source       Repository Path

Event Driven Java Application with Azure Service Bus         Awesome AZD  Azure-Samples/ASA-Samples-Event-Driven-Application
Static React Web App with Java API and PostgreSQL            Awesome AZD  Azure-Samples/ASA-Samples-Web-Application
SAP CAP on Azure App Service Quickstart                      Awesome AZD  Azure-Samples/app-service-javascript-sap-cap-quickstart
SAP Cloud SDK on Azure App Service Quickstart (TypeScript)   Awesome AZD  Azure-Samples/app-service-javascript-sap-cloud-sdk-quickstart
Java Spring Apps with Azure OpenAI                           Awesome AZD  Azure-Samples/app-templates-java-openai-springapps
WordPress with Azure Container Apps                          Awesome AZD  Azure-Samples/apptemplate-wordpress-on-ACA
Bicep template to bootstrap Azure Deployment Environments    Awesome AZD  Azure-Samples/azd-deployment-environments
Starter - Bicep                                              Awesome AZD  Azure-Samples/azd-starter-bicep
Starter - Terraform                                          Awesome AZD  Azure-Samples/azd-starter-terraform
...
# Additional templates omitted

--source Inkludera flaggan till endast listmallar från en specifik källa:

azd template list --source <source-name>

Om du vill initiera en mall från listan som visas kör du kommandot azd init och anger mallens sökväg till lagringsplatsen:

azd init --template <path-value>

Arbeta med Azure-distributionsmiljöer

Azure Developer CLI (azd) tillhandahåller även stöd för Azure-distributionsmiljöer. En Azure Deployment Environment (ADE) är en förkonfigurerad samling Azure-resurser som distribuerats i fördefinierade prenumerationer. Azure-styrning tillämpas på dessa prenumerationer baserat på typen av miljö, till exempel sandbox-miljö, testning, mellanlagring eller produktion. Med Azure Deployment Environments kan du tillämpa företagssäkerhetsprinciper och tillhandahålla en kuraterad uppsättning fördefinierade IaC-mallar (infrastruktur som kod).

ADE-integrering ligger utanför den här artikelns omfång. Läs mer om hur du konfigurerar ade stöd i dokumentationen om Azure Developer CLI för Azure Deployment Environments .

Nästa steg

Kommandoreferens för Azure Developer CLI för Azure Deployment Environments-mall

  • Last updated on