Configurer et consommer des sources de modèle

Azure Developer CLI est conçu autour d’un système de modèle puissant qui simplifie le déploiement et l’approvisionnement de ressources Azure. Lors du développement avec azd, vous avez la possibilité de générer votre propre modèle ou de choisir parmi une liste configurable de modèles existants. Dans cet article, vous allez apprendre à utiliser des listes de modèles et à configurer votre installation locale azd pour prendre en charge différentes sources de liste de modèles.

Comprendre les sources de modèle

Une source de modèle azd pointe vers un fichier de configuration JSON qui décrit une liste de modèles disponibles et leurs métadonnées essentielles, telles que le nom, la description et l’emplacement du code source du modèle (généralement un référentiel GitHub). Lorsque vous activez une source de modèle, les modèles qu’il définit sont mis à disposition via azd d’autres commandes. Par exemple, l’extrait de code JSON source du modèle ci-dessous définit deux modèles :

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

Chaque entrée de modèle dans le fichier de configuration JSON inclut les propriétés suivantes :

• name : Le nom d'affichage du modèle.
• description: bref résumé de ce que fait le modèle.
• repositoryPath: chemin d’accès au code source du modèle, qui peut être :
  • URI complet vers un référentiel Git, tel que «https://dev.azure.com/org/project/_git/repo".
  • « {owner}/{repo} » pour les référentiels GitHub.
  • « {repo} » pour les dépôts GitHub sous l’organisation Azure-Samples.
• tags : Mots-clés qui aident les utilisateurs à filtrer les modèles avec azd init --filter <tag> et azd template list --filter <tag>.

Pour obtenir un exemple complet, consultez ce fichier JSON, qui est la source de modèle par défaut incluse dans azd.

azd vous permet d’activer plusieurs sources de modèle à la fois. Les options de source de modèle suivantes sont actuellement disponibles pour choisir parmi :

• awesome-azd - Une liste des modèles de la galerie AZD géniale activée par défaut.
• par défaut : un petit ensemble de modèles organisés pour illustrer différentes piles techniques.
• fichier : chemin d’accès local/réseau qui pointe vers un fichier de configuration JSON source de modèle.
• URL : chemin d’accès adressable HTTP(S) qui pointe vers un fichier de configuration JSON source de modèle.
• gh : pointe vers un dépôt GitHub.
• ade : pointe vers une liste de modèles d’environnement de déploiement Azure. En savoir plus sur la prise en charge d’Azure Developer CLI pour les environnements de déploiement Azure.

Utiliser des sources de modèle

azd fournit plusieurs commandes pour configurer des sources de modèle.

Utilisez la azd template source list commande pour répertorier toutes les sources de modèle actuellement configurées :

azd template source list

Exemple de sortie avec deux sources de modèle configurées :

Key          Name         Type         Location

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

Utilisez la azd template source add commande pour ajouter une nouvelle source de modèle. Cette commande accepte les paramètres suivants :

• clé : nom technique de la source du modèle.
• --type, -t : le type source du modèle : les valeurs valides sont fichier, URL et gh pour GitHub.
• --location, -l : emplacement source du modèle, qui doit être un RÉSEAU local ou un URI web HTTP(S).
• --name, -n : Le nom d'affichage de la source du modèle (facultatif, utilise la clé s'il est omis).

azd template source add <key> --type <file-or-url-or-gh> --location <your-uri> --name <your-display-name>

Utilisez la azd template source remove commande pour supprimer une source de modèle :

azd template source remove <key>

Utilisez la commande pour rétablir les azd config reset paramètres par défaut de la configuration du modèle :

azd config reset

Utiliser des listes de modèles

Après avoir configuré vos sources de modèle, utilisez la azd template list commande pour répertorier les modèles disponibles à partir de ces sources :

azd template list

Par exemple, une installation par défaut répertorie azd les modèles suivants à partir de la source de modèle 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 

Incluez l’indicateur --source pour répertorier uniquement les modèles à partir d’une source spécifique :

azd template list --source <source-name>

Pour initialiser un modèle à partir de la liste affichée, exécutez la commande azd init et fournissez le chemin du référentiel du modèle :

azd init --template <path-value>

Utiliser des environnements de déploiement Azure

Azure Developer CLI (azd) fournit également la prise en charge des environnements de déploiement Azure. Un environnement de déploiement Azure (ADE) est une collection préconfigurée de ressources Azure déployées dans des abonnements prédéfinis. La gouvernance Azure est appliquée à ces abonnements en fonction du type d'environnement, tel que bac à sable, test, mise en lots ou production. Avec les environnements de déploiement Azure, vous pouvez appliquer des stratégies de sécurité d’entreprise et fournir un ensemble organisé de modèles d’infrastructure prédéfinis en tant que code (IaC).

L’intégration d’ADE dépasse la portée de cet article. En savoir plus sur la configuration ade de la prise en charge dans la documentation azure Developer CLI pour les environnements de déploiement Azure.

Étapes suivantes