Delen via

Sjabloonbronnen configureren en gebruiken

De Azure Developer CLI is ontworpen rond een krachtig sjabloonsysteem dat het implementeren en inrichten van Azure-resources stroomlijnt. Tijdens het ontwikkelen met azd, hebt u de mogelijkheid om uw eigen sjabloon te bouwen of een keuze te maken uit een configureerbare lijst met bestaande sjablonen. In dit artikel leert u hoe u kunt werken met sjabloonlijsten en hoe u uw lokale azd installatie configureert ter ondersteuning van verschillende bronnen voor sjablonenlijsten.

Sjabloonbronnen begrijpen

Een azd sjabloonbron verwijst naar een JSON-configuratiebestand dat een lijst met beschikbare sjablonen en de essentiële metagegevens beschrijft, zoals de naam, beschrijving en locatie van de sjabloonbroncode (meestal een GitHub-opslagplaats). Wanneer u een sjabloonbron inschakelt, worden de sjablonen die worden gedefinieerd, beschikbaar gesteld via azd andere opdrachten. In het onderstaande JSON-codefragment voor de sjabloonbron worden bijvoorbeeld twee sjablonen gedefinieerd:

[
  {
    "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"]
  }
]

Elke sjabloonvermelding in het JSON-configuratiebestand bevat de volgende eigenschappen:

  • naam: de weergavenaam van de sjabloon.
  • beschrijving: een kort overzicht van wat de sjabloon doet.
  • repositoryPath: het pad naar de broncode van de sjabloon, zoals:
    • Een volledig gekwalificeerde URI naar een Git-opslagplaats, zoals 'https://dev.azure.com/org/project/_git/repo".
    • {owner}/{repo} voor GitHub-opslagplaatsen.
    • {repo} voor GitHub-opslagplaatsen onder de Azure-Samples organisatie.
  • tags: trefwoorden waarmee gebruikers sjablonen kunnen filteren met azd init --filter <tag> en azd template list --filter <tag>.

Zie voor een volledig voorbeeld dit JSON-bestand. Dit is de standaardsjabloonbron die is opgenomen in azd.

azd kunt u meerdere sjabloonbronnen tegelijk inschakelen. De volgende sjabloonbronopties zijn momenteel beschikbaar om uit te kiezen:

  • awesome-azd - Een lijst met sjablonen uit de Awesome AZD-galerie die standaard is ingeschakeld.
  • standaard : een kleine set gecureerde sjablonen om verschillende technische stacks te demonstreren.
  • bestand : een lokaal/netwerkpad dat verwijst naar een JSON-configuratiebestand van de sjabloonbron.
  • URL : een http(S) adresseerbaar pad dat verwijst naar een JSON-configuratiebestand van de sjabloonbron.
  • gh : verwijst naar een GitHub-opslagplaats.
  • ade : verwijst naar een lijst met azure-implementatieomgevingssjablonen. Meer informatie over Azure Developer CLI-ondersteuning voor Azure Deployment Environments.

Werken met sjabloonbronnen

azd biedt verschillende opdrachten voor het configureren van sjabloonbronnen.

Gebruik de azd template source list opdracht om alle momenteel geconfigureerde sjabloonbronnen weer te geven:

azd template source list

Voorbeelduitvoer met twee geconfigureerde sjabloonbronnen:

Key          Name         Type         Location

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

Gebruik de azd template source add opdracht om een nieuwe sjabloonbron toe te voegen. Met deze opdracht worden de volgende parameters geaccepteerd:

  • sleutel: De technische naam van de sjabloonbron.
  • --type, -t: het brontype van de sjabloon- geldige waarden zijn bestand, URL en gh voor GitHub.
  • --location, -l: de bronlocatie van de sjabloon, die een lokaal netwerk of HTTP(S) web-URI moet zijn.
  • --name, -n: De weergavenaam van de sjabloonbron (optioneel, gebruikt sleutel indien weggelaten).
azd template source add <key> --type <file-or-url-or-gh> --location <your-uri> --name <your-display-name>

Gebruik de azd template source remove opdracht om een sjabloonbron te verwijderen:

azd template source remove <key>

Gebruik de azd config reset opdracht om de sjabloonconfiguratie opnieuw in te stellen op standaardinstellingen:

azd config reset

Werken met sjabloonlijsten

Nadat u de sjabloonbronnen hebt geconfigureerd, gebruikt u de azd template list opdracht om de beschikbare sjablonen uit deze bronnen weer te geven:

azd template list

Een standaardinstallatie van een lijst met azd de volgende sjablonen uit de bron van de awesome-azd-sjabloon :

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

Voeg de --source vlag toe aan alleen lijstsjablonen uit een specifieke bron:

azd template list --source <source-name>

Als u een sjabloon wilt initialiseren vanuit de weergegeven lijst, voert u de opdracht azd init uit en geeft u het pad naar de opslagplaats van de sjabloon op:

azd init --template <path-value>

Werken met Azure-implementatieomgevingen

De Azure Developer CLI (azd) biedt ook ondersteuning voor Azure Deployment Environments. Een ADE (Azure Deployment Environment) is een vooraf geconfigureerde verzameling Azure-resources die zijn geïmplementeerd in vooraf gedefinieerde abonnementen. Azure-governance wordt toegepast op deze abonnementen op basis van het type omgeving, zoals sandbox, testen, faseren of productie. Met Azure Deployment Environments kunt u beveiligingsbeleidsregels voor ondernemingen afdwingen en een gecureerde set vooraf gedefinieerde infrastructuur als codesjablonen (IaC) bieden.

ADE-integratie valt buiten het bereik van dit artikel. Meer informatie over het configureren van ade ondersteuning in de Documentatie voor Azure Developer CLI voor Azure Deployment Environments .

Volgende stappen

Naslaginformatie over azure Developer CLI-ondersteuning voor azure Deployment EnvironmentsTemplate list

  • Last updated on