Utiliser GitHub Copilot avec Azure Developer CLI

Azure Developer CLI (azd) s’intègre à GitHub Copilot pour fournir une structure de projet assistée par l’IA durant azd init, ainsi qu’un dépannage intelligent lorsque des erreurs de commande surviennent.

Lorsque vous exécutezazd init, azd présente une option Configurer avec GitHub Copilot (préversion). Si cette option est sélectionnée, Copilot analyse votre codebase et génère, les modèles d’infrastructure et la configuration de déploiement en fonction du langage, de l’infrastructure et des dépendances azure.yamlde votre code. L'init propulsé par copilote prend en charge les projets nouveaux et existants.

En cas d’échec d’une azd commande, azd vous pouvez utiliser Copilot pour analyser l’erreur, suggérer un correctif et l’appliquer automatiquement.

Prerequisites

Pour utiliser ces fonctionnalités, vous avez besoin des éléments suivants :

  • azd 1.23.11 ou version ultérieure : exécuter azd version pour vérifier ou azd update obtenir la dernière version.
  • Accès à GitHub Copilot : abonnement GitHub Copilot actif (individuel, professionnel ou entreprise).
  • GitHub CLI (gh) : azd vérifie et invite automatiquement la connexion si nécessaire.
  • GitHub CLI (gh) :installez l’interface CLI GitHub. azd vérifie gh automatiquement l'authentification et demande la connexion si nécessaire.

Structurer un projet avec Copilot et azd init

L’exemple suivant montre comment utiliser l’init alimenté par Copilot pour mettre en place un projet d’API Express avec une dépendance PostgreSQL.

Avant d’apporter des modifications, le flux exécute des vérifications préliminaires. Il vérifie que votre répertoire de travail Git est propre, de sorte qu’aucun travail non validé n’est à risque. Il demande également, à l'avance, le consentement pour l'outil serveur MCP (Model Context Protocol), afin que vous puissiez examiner les outils auxquels Copilot a accès.

  1. Exécutez azd init et sélectionnez Configurer avec GitHub Copilot (préversion) :

    azd init
# Select: "Set up with GitHub Copilot (Preview)"

  2. Copilot examine votre structure de projet et détecte la dépendance Express Framework et PostgreSQL à partir de vos fichiers projet.

  3. Copilot détermine le type host approprié (containerapp) et language (js) pour le service.

  4. Copilot génère un azure.yaml avec la configuration de service correcte.

  5. Copilot crée des modules Bicep pour Azure Container Apps et Azure Database pour PostgreSQL en fonction des dépendances détectées.

  6. Passez en revue et approuvez les fichiers générés avant qu’ils ne soient écrits sur le disque.

Une fois l'échafaudage terminé, provisionnez et déployez le projet en exécutant azd up comme d’habitude :

azd up

Pour plus d’informations sur le azd up flux de travail, consultez Explorer le flux de travail azd up.

Résolution des problèmes d’erreur assistés par l’IA

En cas d’échec d’une azd commande, azd vous pouvez utiliser Copilot pour analyser l’erreur et suggérer un correctif. Copilot utilise la configuration de votre projet et les détails de l’erreur pour fournir une résolution des problèmes spécifiques au contexte directement dans votre terminal. Vous pouvez choisir parmi plusieurs options interactives, configurer un comportement par défaut ou laisser Copilot auto-corriger et réessayer.

Options de résolution des problèmes de Copilot

Lorsqu’une commande échoue, azd affiche une invite interactive avec quatre options. Utilisez les touches de direction pour sélectionner une option et appuyez sur Entrée :

  • Expliquer : obtenez une explication en langage simple de ce qui s’est passé.
  • Conseils : recevez des instructions pas à pas pour résoudre le problème.
  • Diagnostiquer et guider : obtenez des étapes de résolution des problèmes sur ce qui s’est passé, pourquoi l’erreur s’est produite et comment la corriger. Laissez Copilot appliquer un correctif (avec votre approbation), puis réessayez éventuellement la commande ayant échoué.
  • Ignorer : ignorer et gérer l’erreur manuellement.
? How would you like to proceed?  [Use arrows to move, type to filter]
> Explain
  Guidance
  Diagnose and Guide
  Skip

Copilot utilise votre configuration de projet, la commande qui a échoué et les détails de l’erreur pour fournir des suggestions spécifiques à votre situation.

Définir un comportement de gestion des erreurs par défaut

Si vous préférez utiliser la même option de manière cohérente, définissez une valeur par défaut avec azd config pour ignorer l’invite interactive.

azd config set copilot.errorHandling.category troubleshoot

Valeurs disponibles pour copilot.errorHandling.category:

Valeur Comportement
explain Obtenez automatiquement une explication en langage brut.
guidance Obtenez automatiquement des instructions de correction pas à pas.
troubleshoot Diagnostiquer et guider automatiquement.
fix Appliquez automatiquement un correctif.
skip Ignorez toujours la résolution des problèmes de Copilot.

Vous pouvez également activer la correction automatique et la nouvelle tentative. Copilot applique donc automatiquement le correctif et réexécute la commande ayant échoué :

azd config set copilot.errorHandling.fix allow

Pour réinitialiser l’invite interactive par défaut, annulez la configuration :

azd config unset copilot.errorHandling.category

Erreurs courantes de déploiement Azure où Copilot aide

Les exemples suivants montrent les erreurs de déploiement courantes d'Azure et comment la résolution des problèmes avec l'assistance de Copilot vous aide à les résoudre.

MissingSubscriptionRegistration — Fournisseur de ressources non inscrit

Un premier déploiement sur un abonnement peut échouer avec :

ERROR: deployment failed: MissingSubscriptionRegistration:
The subscription is not registered to use namespace 'Microsoft.App'.

Azure exige que les fournisseurs de ressources soient inscrits avant de pouvoir créer certains types de ressources. Si ce déploiement d’application conteneur est le premier déploiement dans un abonnement donné, Microsoft.App n’est pas encore inscrit. L’option Résoudre les problèmes peut inscrire le fournisseur et réexécuter automatiquement le déploiement.

SkuNotAvailable / OperationNotAllowed — Référence SKU ou limites de quota

Vous pouvez rencontrer une erreur de disponibilité de référence SKU :

ERROR: deployment failed: SkuNotAvailable:
The requested VM size 'Standard_D2s_v3' is not available in location 'westus'.

Ou une variante de quota :

ERROR: deployment failed: OperationNotAllowed:
Operation results in exceeding quota limits of Core.
Maximum allowed: 4, Current in use: 4, Additional requested: 2.

Ces erreurs sont courantes lorsqu’une région est limitée à la capacité ou que votre abonnement atteint sa limite de processeurs virtuels. L’option Explication de Copilot précise la référence SKU ou le quota bloqué, et Les conseils suggèrent d’autres régions ou tailles de machine virtuelle disponibles ou vous montre comment demander une augmentation de quota.

StorageAccountAlreadyTaken — collision de nom globalement unique

ERROR: deployment failed: StorageAccountAlreadyTaken:
The storage account named 'myappstorage' is already taken.

Les noms de compte de stockage doivent être uniques dans l’ensemble d’Azure. Copilot suggère de mettre à jour votre paramètre Bicep ou azure.yaml variable d’environnement avec un nom unique, souvent en ajoutant votre nom d’environnement ou un suffixe aléatoire, puis réessayez le déploiement.

Contenu connexe

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.

  • Last updated on