Vue d’ensemble du développement de modèles Azure Developer CLI (azd)

Les modèles Azure Developer CLI (azd) regroupent la configuration, l’infrastructure et, éventuellement, le code d’application nécessaires pour approvisionner et déployer une solution sur Azure. Vous pouvez utiliser un modèle pour une application, un projet infrastructure uniquement ou un point de départ réutilisable pour les projets futurs.

Note

Avant de commencer, lisez les modèles Azure Developer CLI pour obtenir une description complète de la structure des modèles, des ressources requises et facultatives, des associations entre services et ressources, et de la façon dont les commandes azd utilisent chaque fichier.

Workflow de développement de modèle

Le flux de travail suivant s’applique si vous créez un modèle ou initialisez-en un qui existe déjà :

Schéma du flux de travail de développement de modèles pour Azure Developer CLI. Sur la gauche, une zone intitulée « Choisir un point de départ » contient deux options : « Démarrer avec un nouveau modèle » et « Démarrer à partir d’un modèle existant ». Les deux options mènent à « Explorer et modifier les fichiers de modèle ». À partir de là, un chemin facultatif mène à « Étendre le modèle », et le chemin principal continue vers « Exécuter azd up ». L’étape « Étendre le modèle » mène également à « Exécuter azd up ». Enfin, « Exécuter azd up » conduit ensuite à « Maintenir ou partager le modèle ».

• Choisissez un point de départ :Commencez par un nouveau modèle avec l’intégration GitHub Copilot, un autre assistant de codage IA ou la création directe. Vous pouvez également commencer à partir d’un modèle existant à partir de Microsoft, de votre organisation ou de la communauté des développeurs.
• Explorez et modifiez les fichiers : Passez en revue comment azure.yamlles fichiers, Bicep ou Terraform, le code de l’application et la prise en charge de la configuration fonctionnent ensemble. Consultez Explorer et modifier des fichiers de modèle.
• Étendez et évoluez selon les besoins : Ajoutez, remplacez, supprimez ou remaniez les composants d’application et d’infrastructure. Suivez Étendre un modèle pour voir un exemple complet qui ajoute une ressource Azure et la relie à une application.
• Provisionner et déployer : Exécutez azd up pour provisionner l’infrastructure et déployer tous les services d’application. Pour plus d’informations, consultez Explorer le azd up flux de travail.
• Gérer ou partager : Continuez à modifier le modèle à mesure que votre projet évolue. Si vous prévoyez de le partager, testez-le d’abord dans un répertoire propre et avec un azd nouvel environnement.

Note

Tout au long de ce flux de travail, vous pouvez créer, modifier ou remplacer des fichiers de modèle vous-même ou avec l’aide d’un assistant de codage IA. Le résultat est le même ensemble de ressources standard modifiables azd .

Blocs de construction de modèle

Chaque azd modèle prend en charge une solution différente, mais la plupart des modèles combinent les mêmes types de ressources :

• Configuration du projet : Le fichier azure.yaml identifie le projet, les services déployables, les répertoires source, les cibles d’hébergement et les hooks ou workflows facultatifs.
• Infrastructure en tant que code : Bicep ou les fichiers Terraform définissent les ressources Azure, les attributions de rôles, la mise en réseau et les paramètres d’application requis par la solution.
• Source de l’application : Un modèle peut inclure une ou plusieurs applications déployables, ou il ne peut contenir qu’une infrastructure.
• Configuration de l’environnement : Les paramètres passent des valeurs spécifiques à l’environnement dans les déploiements, et les sorties d’infrastructure deviennent des valeurs dans l’environnement actif azd .

Un modèle pour une application peut utiliser la structure de dossiers suivante :

.
├── azure.yaml                # Project configuration
├── infra/                    # Infrastructure as code
│   ├── main.bicep
│   ├── main.parameters.json
│   └── modules/
├── src/                      # Application source
│   ├── api/
│   └── web/
├── .github/                  # Pipeline workflows
│   └── workflows/
└── README.md

La structure exacte varie selon le projet. La source d’application, les modules d’infrastructure et les fichiers de pipeline sont facultatifs et azure.yaml identifient les chemins d’accès utilisés azd . Ces ressources fonctionnent ensemble tout au long du cycle de vie du développement du modèle.

Étapes suivantes

Commencer avec un nouveau modèle

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 Azure développeur, visitez la page troubleshooting et support.