Vue d’ensemble des extensions AZURE Developer CLI

Les extensions Azure Developer CLI (azd) sont des composants modulaires qui étendent les fonctionnalités de l’interface CLI développeur Azure. Ils vous permettent d’ajouter de nouvelles fonctionnalités, d’automatiser les flux de travail et d’intégrer d’autres services directement à partir de l’interface CLI. Utilisez des extensions pour adapter azd les besoins de l’équipe en constante évolution et les scénarios Azure.

Gérer les sources d’extension

Vous pouvez découvrir, installer et mettre à jour des extensions à mesure que vos besoins augmentent. Les sources d’extension gèrent la distribution et la gestion.

• Les sources d’extension sont des manifestes basés sur des fichiers ou des URL qui fournissent des listes d’extensions disponibles azd .
• Vous pouvez ajouter des sources d’extension personnalisées qui se connectent à des registres privés, locaux ou publics.
• Les sources d’extension sont un concept équivalent aux flux NuGet ou Node Gestionnaire de package (NPM) et doivent respecter le schéma officiel du registre d’extensions.

azd prend en charge plusieurs façons de résoudre les extensions :

• Le registre de source d’extension officiel est préconfiguré azd et est hébergé à l’adresse https://aka.ms/azd/extensions/registry.
• Les sources basées sur des URL référencent des manifestes de Registre distants que votre équipe héberge pour la distribution publique ou privée.
• Les sources basées sur des fichiers référencent des manifestes de Registre local pour une utilisation hors connexion ou un développement local.
• Les registres de développement et nocturnes sont des sources d’adhésion pour les extensions de travail en cours et intégrées automatiquement. Utilisez-les pour tester des scénarios au lieu de flux de travail de production.
• Les fichiers groupés autonomes fournissent des packages portables .zip pour une installation directe lorsque vous ne souhaitez pas héberger un registre.

Les noms de sources d’extension personnalisés doivent contenir 1 à 64 lettres ASCII minuscules ou chiffres. Vous pouvez inclure des traits d’union (-) et des traits de soulignement (_) entre des lettres ou des chiffres. Les noms doivent commencer et se terminer par une lettre ou un chiffre. azd retourne une erreur pour les noms non valides ; il ne les normalise pas. Les noms azd et bundle sont réservés et ne peuvent pas être utilisés pour les sources personnalisées.

La source préconfigurée azd est le registre officiel. Vous ne pouvez pas le supprimer ou modifier son emplacement.

Pour choisir le registre de développement, exécutez la commande suivante :

# Add a new extension source name 'dev' to your `azd` configuration.
azd extension source add -n dev -t url -l "https://aka.ms/azd/extensions/registry/dev"

Commandes de l'extension source

Utilisez les commandes suivantes pour gérer les sources d’extension pour votre azd installation.

Répertorier les sources d’extension installées

azd extension source list

Ajouter une nouvelle source d’extension

azd extension source add -n <name> -t url -l <registry-url>

• -l, --location: emplacement de la source d’extension.
• -n, --name: nom de la source d’extension. Utilisez un nom de source personnalisé valide.
• -t, --type: type de source d’extension. Les types pris en charge sont des fichiers et une URL.

Supprimer une source d’extension

azd extension source remove <name>

Vous ne pouvez pas supprimer la source préconfigurée azd .

Si une mise à niveau signale une erreur de chargement source provoquée par un nom source non valide hérité dans ~/.azd/config.json, supprimez la source incriminée avec azd extension source remove, puis ajoutez-la à nouveau avec un nom valide.

Gérer les extensions

Après avoir activé les extensions et configuré vos sources d’extension, installez les extensions pour ajouter de nouvelles fonctionnalités à azd. Pour obtenir un exemple d’utilisation des extensions, consultez Démarrage rapide : utilisez l’extension IA.

Répertorier les extensions

azd extension list [flags]

• --installed Affiche la liste des extensions installées.
• --source Répertorie uniquement les extensions de la source spécifiée. Le nom de la source doit être un nom source inscrit valide.
• --tags Filtre les extensions par balises, telles que l’IA ou le test.

Installer une extension

azd extension install <extension-names> [flags]

Remplacez <extension-name> par le nom de l’extension que vous souhaitez installer.

• -v, --version Spécifie la contrainte de version à appliquer lors de l’installation d’extensions.
• -s, --source Spécifie la source d’extension utilisée pour les installations. Le nom de la source doit être un nom source inscrit valide.

Mettre à niveau une extension

azd extension upgrade <extension-name>

• --all Met à niveau toutes les extensions précédemment installées quand elles sont spécifiées.
• -v, --version Met à niveau une extension spécifiée à l’aide d’une contrainte de version, si elle est fournie.
• -s, --source Spécifie la source d’extension utilisée pour les installations. Le nom de la source doit être un nom source inscrit valide.

Désinstaller une extension

azd extension uninstall <extension-name>

• --all Supprime toutes les extensions installées quand elles sont spécifiées.

Déclarer les extensions requises dans un projet

Les projets peuvent déclarer les extensions requises afin azure.yaml de azd résoudre et d’installer les versions d’extension dont le projet a besoin. Ajoutez les exigences d’extension sous requiredVersions.extensions, et utilisez latest, une version exacte ou une contrainte de version sémantique prise en charge.

requiredVersions:
  extensions:
    azure.ai.agents: ">=1.0.0"
    contoso.azd.tagger: "^2.0.0"

Utilisez les exigences au niveau du projet lorsqu’un modèle dépend des hôtes de service fournis par l’extension, des gestionnaires de cycle de vie, des fournisseurs de validation ou des commandes. Pour obtenir les détails complets de la contrainte de schéma et de version, consultez requiredVersions.

Comprendre les points d’intégration d’extension

Les extensions peuvent s’intégrer de azd plusieurs façons :

• Ajoutez des espaces de noms de commandes avec des métadonnées, de l’aide et des exemples.
• Fournissez des schémas de configuration et des métadonnées IntelliSense pour les fichiers projet.
• Inscrivez des gestionnaires d’événements de cycle de vie pour les flux de travail tels que l’approvisionnement, le package et le déploiement.
• Ajoutez des fournisseurs pour la prise en charge personnalisée de l’approvisionnement, de la validation, des cibles de service et du langage ou de l’infrastructure.
• Exposer les fonctionnalités du serveur MCP (Model Context Protocol) pour les agents et les outils de développement.

Pour obtenir des conseils d’implémentation, consultez les concepts de développement d’extension.

Utiliser des extensions azd dans des conteneurs de développement

La azd fonctionnalité de conteneur de développement prend en charge une option permettant d’installer extensions automatiquement une liste d’extensions azd séparées par des virgules pendant la génération du conteneur. Les extensions installées de cette façon sont disponibles dès le démarrage du conteneur, ce qui réduit la configuration manuelle et permet aux commandes azd de s'exécuter avec les extensions requises déjà installées.

Pour installer automatiquement les extensions, ajoutez l’option extensions à l’entrée azd de fonctionnalité dans votre devcontainer.json fichier :

{
    "name": "Azure Developer CLI",
    "image": "mcr.microsoft.com/devcontainers/python:3.10-bullseye",
    "features": {
        "ghcr.io/azure/azure-dev/azd:latest": {
            "extensions": "my-ext-1,my-ext-2"
        }
    }
}

La extensions valeur est une liste séparée par des virgules de noms d’extension azd . L’installation se produit pendant la build du conteneur, de sorte que les extensions sont prêtes à être utilisées dès que le conteneur démarre. Après avoir modifié la liste des extensions, utilisez la commande Reconstruire et rouvrir dans le conteneur de développement dans Visual Studio Code pour reconstruire le conteneur avec les extensions mises à jour.

En savoir plus sur la fonctionnalité de conteneur de développement azd.

Étapes suivantes

• Démarrage rapide : Utiliser l’extension IA
• Concepts de développement d’extension
• Démarrage rapide : Générer un exemple d’extension azd
• Fichier README du cadre d’extension