Partage via


Vue d’ensemble des modèles AZURE Developer CLI

Azure Developer CLI (azd) utilise des modèles pour approvisionner et déployer des ressources d’application dans le cloud. Les développeurs peuvent ajouter la prise en charge des azd commandes et des fonctionnalités en convertissant leurs applications en modèles. Cet article fournit une vue d’ensemble contextuelle des différentes options de création azd de modèles. Une fois que vous avez compris les concepts de cet article, consultez les ressources suivantes pour obtenir des guides d’implémentation plus détaillés :

Remarque

Cet article suppose une compréhension générale des azd modèles. Pour plus d’informations sur les modèles, consultez la documentation de présentation du modèle.

Concepts de création de modèle

La création d’un modèle nécessite l’ajout azd de ressources de configuration et d’infrastructure spécifiques à votre base de code existante ou le démarrage d’une nouvelle application à partir d’un modèle existant ces mêmes ressources. Les deux flux de travail sont expliqués dans les sections ultérieures. Tous les azd modèles partagent une structure de fichiers similaire basée sur des azd conventions. Le diagramme suivant donne une vue d’ensemble rapide du processus pour créer un azd modèle :

Diagramme du flux de travail du modèle AZURE Developer CLI.

Chaque azd modèle nécessite les ressources minimales suivantes :

  • Dossier infra qui contient l’infrastructure en tant que fichiers de code (Bicep ou Terraform).
  • Fichier azure.yaml de configuration qui mappe vos services d’application aux ressources d’infrastructure approvisionnées.

D’autres répertoires facultatifs sont également inclus, tels qu’un .github dossier contenant des ressources pour créer un pipeline CI/CD. Pour plus d’informations sur les modèles, consultez la documentation de présentation du modèle.

Considérez l’exemple de référentiel d’application suivant :

Capture d’écran montrant la structure de l’exemple d’application.

Après avoir converti cet exemple d’application en modèle azd , le même référentiel d’applications contient les éléments suivants :

Capture d’écran montrant la structure terminée du modèle azd.

Les ressources d’application d’origine sont inchangées, mais de nouvelles ressources ont été ajoutées qui azd dépendent des commandes telles que azd up:

  • Un infra dossier a été ajouté qui inclut des fichiers Bicep pour créer des ressources Azure.
  • Un azure.yaml fichier de configuration a été ajouté pour mapper le code de l’application dans le src répertoire aux ressources Azure approvisionnées.
  • Un .azure dossier a été créé pour contenir des azd variables d’environnement.
  • Un .github dossier (facultatif) a été ajouté pour prendre en charge les pipelines CI/CD via des actions GitHub.

Flux de travail de création de modèles

La azd init commande est utilisée pour initialiser un azd modèle pour l’approvisionnement et le déploiement des ressources d’application sur Azure. La commande vous invite à choisir entre deux flux de travail différents pour initialiser un modèle décrit dans les sections suivantes : utilisez du code dans le répertoire actif et utilisez un modèle existant.

Exécutez la azd init commande à la racine du répertoire que vous souhaitez convertir en :azd template

azd init

Capture d’écran montrant le processus d’init du modèle.

Utiliser du code dans le répertoire actif

Cette option indique azd d’analyser le code de votre annuaire pour identifier les technologies qu’il utilise, telles que le langage de programmation, l’infrastructure et le système de base de données. azd génère automatiquement des ressources de modèle pour vous, telles que le azure.yaml fichier de définition de service et le infra dossier avec des fichiers infrastructure-as-code. Les ressources générées constituent un point de départ pour des modifications supplémentaires. Utilisez cette approche si vous envisagez d’utiliser les services Azure courants pris en charge par azd les fonctionnalités de génération automatique.

Visitez le guide de démarrage avec votre code d’application pour créer un didacticiel de modèle pour plus d’informations sur l’implémentation de cette approche et plus d’informations sur les ressources Azure qui prennent en charge la détection automatique et la génération de modèles.

Sélectionner un modèle

Sélectionnez cette option pour utiliser un modèle existant qui définit un grand nombre de vos ressources Azure et des objectifs architecturaux comme point de départ. azd vous invite à sélectionner un modèle de démarrage ou un autre modèle à partir de la galerie géniale . Lorsque vous sélectionnez un modèle, les ressources de ce modèle sont ajoutées à votre répertoire de projet existant à utiliser comme point de départ. Certains modèles incluent des exemples de code d’application que vous pouvez remplacer par vos propres, tandis que certains (appelés « modèles de démarrage ») sont uniquement une infrastructure.

Utilisez la azd init commande pour extraire un modèle existant dans un répertoire vide et l’utiliser comme point de départ pour votre propre application. Si le modèle inclut du code source d’application, vous pouvez soit générer à partir de ce code, soit remplacer le répertoire de code source par votre propre code.

Consultez le didacticiel Démarrer avec un modèle existant pour plus d’informations sur l’implémentation de cette approche.

Voir aussi

Demander de l’aide

Pour plus d’informations sur la façon de déposer un bogue, de demander de l’aide ou de proposer une nouvelle fonctionnalité pour l’interface CLI développeur Azure, visitez la page de dépannage et de support .

Étapes suivantes