Partage via

Installer ou mettre à jour l’interface CLI Azure Développeur

Bienvenue dans l’interface CLI Azure Développeur (azd) ! Commençons par installer et apprendre à exécuter azd.

Commencez par sélectionner votre environnement de développement. Pour plus d’informations sur les avantages et inconvénients des différents choix d’environnement de développement, consultez Azure environnements pris en charge par l’interface CLI développeur (azd).

Pour des instructions et des scénarios d'installation plus avancés, consultez les scripts d'installation pour Azure Developer CLI.

Remarque : Lorsque vous installez azd, les outils suivants sont installés dans l’étendue azd (ce qui signifie qu’ils ne sont pas installés globalement) et sont supprimés si azd est désinstallé :

  • L'interface en ligne de commande GitHub
  • L’interface CLI Bicep

Installer azd

winget install microsoft.azd

Mettre à jour azd

winget upgrade microsoft.azd

Désinstaller azd

winget uninstall microsoft.azd

Note

Sur les Apple Silicon Macs (M1 et M2) azd nécessite Rosetta 2. Si Rosetta 2 n’est pas déjà installé, exécutez softwareupdate --install-rosetta depuis le terminal.

Le azd processus d’installation choisit automatiquement le fichier binaire approprié pour l’architecture de votre ordinateur.

Installer azd

brew install azure/azd/azd

Si vous utilisez brew pour mettre à niveau azd depuis une version installée sans brew, supprimez la version existante de azd à l'aide du script de désinstallation (si elle est installée à l'emplacement par défaut) ou en supprimant manuellement le binaire azd. Cette opération installe automatiquement la version correcte.

Mettre à jour azd

brew upgrade azure/azd/azd

Désinstaller azd

brew uninstall azd

Installer azd

curl -fsSL https://aka.ms/install-azd.sh | bash

Mettre à jour azd

curl -fsSL https://aka.ms/install-azd.sh | bash

Lorsque vous installez azd, les outils suivants sont installés dans l’étendue azd (ce qui signifie qu’ils ne sont pas installés globalement) et sont supprimés si azd est désinstallé :

Désinstaller azd

curl -fsSL https://aka.ms/uninstall-azd.sh | bash

Prerequisites

Avant de commencer à utiliser azd, vérifiez que vous disposez des points suivants :

Installer azd dans un conteneur de développement

Un conteneur de développement est une image Docker qui inclut toutes les conditions préalables requises pour exécuter une application sur votre ordinateur local. Installez azd en tant que fonctionnalité dans votre conteneur de développement en procédant comme suit :

  1. Ajoutez la azd fonctionnalité au fichier devcontainer.json dans le dossier .devcontainer à la racine de votre modèle.

    {
    "name": "Azure Developer CLI",
    "image": "mcr.microsoft.com/devcontainers/python:3.10-bullseye",
    "features": {
        // See https://containers.dev/features for list of features
        "ghcr.io/devcontainers/features/docker-in-docker:2": {
        },
        "ghcr.io/azure/azure-dev/azd:latest": {}
    }
    // Rest of file omitted...
}

  2. Régénérez et exécutez votre conteneur de développement. Dans Visual Studio Code, utilisez la palette de commandes pour exécuter la commande Rebuild and Reopen in Dev Container.

Installation automatique d’extensions azd

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.

Vérification de votre installation

Vérifiez que votre azd installation s’est terminée correctement en exécutant la azd version commande dans un terminal :

azd version

azd imprime la version actuelle :

azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)

Mettre à jour la CLI Azure Developer

Lorsque vous utilisez une version azdobsolète, vous verrez un avertissement pour effectuer une mise à niveau vers la dernière version. Suivez les instructions de l’avertissement pour effectuer la mise à jour vers la dernière version.

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.

Étapes suivantes

Démarrage rapide - Sélectionner et déployer un modèle azd

Qu’est-ce que les modèles CLI développeur Azure ?

FAQ Azure Developer CLI

  • Last updated on