Commencez avec un nouveau modèle Azure Developer CLI (azd)

Vous pouvez utiliser différentes méthodes de création pour générer les fichiers standard dans un nouveau modèle AZURE Developer CLI (azd) :

• Utilisez l’intégration GitHub Copilot dans azd init. Le flux de travail intégré analyse les fichiers projet existants ou vous aide à planifier un nouveau projet, crée les ressources de modèle et exécute la validation de prédéploiement.
• Utilisez un autre assistant de codage IA. Demandez à l’assistant de créer les mêmes fichiers azure.yaml, d’infrastructure en tant que code, d’application et de support, sans intégration directe avec azd init.
• Créez les fichiers directement. Créez et modifiez vous-même les ressources de modèle lorsque vous souhaitez contrôler complètement ou n’utilisez pas d’assistant de codage IA.

Cet article se concentre principalement sur le flux de travail de GitHub Copilot intégré, car il fournit une expérience guidée intégrée à azd. Quelle que soit la méthode de création, passez en revue et validez chaque fichier avant le déploiement.

Important

L’intégration GitHub Copilot dans azd init est en préversion. Les fonctionnalités en préversion peuvent changer avant la disponibilité générale. Pour plus d’informations, consultez la azd stratégie de version et de mise en production des fonctionnalités.

Les ressources générées sont des fichiers de modèle standard et modifiables azd . Après l’initialisation, vous pouvez les mettre à jour directement ou avec n’importe quel assistant de codage IA.

Conditions préalables pour GitHub Copilot

Pour utiliser le flux de travail intégré Copilot, vous avez besoin des éléments suivants :

• Azure Developer CLI 1.23.11 ou version ultérieure.
• Un abonnement actif GitHub Copilot.
• Git, que azd init utilise pour inspecter l’arborescence de travail avant de modifier des fichiers.
• Session de terminal interactive.

Si vous n'êtes pas déjà authentifié avec GitHub Copilot, azd vous invite à vous connecter.

Exécutez azd version pour vérifier la version de l’interface CLI du développeur installée Azure.

Note

Le azd init flux de travail démarre une session GitHub dédiée assistant Copilot dans le terminal. Il n'utilise pas ou ne poursuit pas une session de Copilot Chat GitHub active dans Visual Studio Code.

Générer avec GitHub Copilot

1. Ouvrez un terminal dans le répertoire dans lequel vous souhaitez générer le modèle.

   Note

   Le répertoire peut contenir une application existante, un projet d’infrastructure ou les fichiers initiaux d’une nouvelle solution. Si le répertoire contient des modifications non validées, azd vous invite à confirmer avant de continuer. Validez d’abord vos modifications importantes ou mettez-les de côté.

2. Exécutez azd init:

   azd init
   

3. Sélectionnez Configurer avec GitHub Copilot (aperçu).

   L’invite d’initialisation ressemble à l’exemple suivant :

   ? How do you want to initialize your app?
      Scan current directory
      Select a template
   > Set up with GitHub Copilot (Preview)
   

4. Passez en revue l’accès à l’outil demandé et accordez l’accès aux outils requis pour le flux de travail. Copilot utilise azd et Azure fonctionnalités de développement pour inspecter le projet, créer des fichiers et valider le résultat.

5. Sélectionnez un modèle et un niveau de raisonnement si azd vous demande de les configurer.

   Lors du premier lancement, les messages utilisent les étiquettes suivantes. Le modèle disponible et les choix de raisonnement dépendent de votre compte GitHub Copilot et du modèle sélectionné :

   ? Select AI model
   ? Select reasoning effort level
   

6. Décrivez ce que vous souhaitez créer. Incluez les exigences pertinentes telles que :

   • Indique si le modèle inclut le code d’application, l’infrastructure uniquement ou les deux.
   • Langages et frameworks d’application, s’ils sont connus.
   • Les services Azure et la plateforme d’hébergement à utiliser.
   • Indique s’il faut utiliser Bicep ou Terraform.
   • Exigences en matière de sécurité, de mise en réseau, de mise à l’échelle et de région.

   Par exemple:

   Build an infrastructure-only azd template that provisions an Azure Container Apps
   environment, Azure Container Registry, and Log Analytics workspace with Bicep.
   Use managed identity and least-privilege role assignments. Parameterize the location
   and environment name so the template can be reused.
   

7. Répondez à toutes les questions d’architecture ou de configuration de Copilot. L’agent prépare le projet pour Azure, génère les ressources du modèle et exécute la validation de prédéploiement.

8. Passez en revue la structure d’ensemble des fichiers que Copilot a créés ou modifiés. Vérifiez que le modèle inclut la configuration de projet attendue, le répertoire d’infrastructure, la source de l’application et les ressources de prise en charge de votre solution.

   Par exemple, un modèle d’infrastructure uniquement généré peut contenir les fichiers clés suivants :

   azure.yaml
   infra/
   ├── main.bicep
   ├── main.parameters.json
   └── modules/
      ├── container-apps-environment.bicep
      └── container-registry.bicep
   

   Pour obtenir des instructions détaillées sur l’examen du contenu de la configuration et de l’infrastructure, consultez Explorer et modifier des fichiers de modèle.

Approvisionner et déployer le modèle

Après avoir approuvé les fichiers générés, exécutez la commande suivante :

azd up

La commande crée ou sélectionne un environnement, provisionne les ressources Azure, empaquette tous les services d’application azd et les déploie. Pour obtenir une répartition détaillée des commandes, consultez Explorer le azd up flux de travail.

Utiliser une autre méthode de création

D’autres assistants de codage IA ne sont pas connectés directement au azd init flux de travail, mais ils peuvent créer les mêmes ressources de modèle standard. Vous pouvez également créer chaque ressource directement.

Créez vous-même ces ressources ou demandez à un autre assistant de codage d’analyser vos besoins et de les créer :

• Fichier azure.yaml qui définit le projet et les services déployables.
• Fichiers Bicep ou Terraform qui déploient les ressources Azure requises.
• Sorties de ressources et variables d’environnement d’application.
• fichiers Docker, configuration de déploiement et scripts de support, si nécessaire.

Pour fournir un point de départ minimal avant d’utiliser un autre agent, exécutez :

azd init --minimal

Si vous utilisez un autre assistant de codage, demandez-lui de suivre le azure.yaml schéma, Azure pratiques de sécurité de l’infrastructure et les conventions de modèle décrites dans Azure modèles CLI pour développeurs. Si vous créez les fichiers directement, utilisez les mêmes références que votre guide d’implémentation. Passez en revue et validez tous les fichiers avant d’exécuter azd up.

Contenu connexe

• Vue d’ensemble du développement de modèles
• Explorer et modifier des fichiers de modèle
• Démarrer à partir d’un modèle existant
• Étendre un modèle
• Explorer le azd init flux de travail

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.