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 Environnements pris en charge par Azure Developer CLI (azd).

Pour des scénarios d’installation et des instructions plus avancés, consultez les scripts d’installation de l’interface CLI Azure Developer.

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é :

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 --cask 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 commande pour exécuter la commande Reconstruire et rouvrir dans un conteneur de développement.

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 Rebuild et Rouvrez 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é azd Dev Container Feature.

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 pour développeurs Azure

Vous pouvez effectuer une mise à jour à azd l’aide de la commande intégrée azd update (bêta) ou manuellement à l’aide de la même méthode que celle que vous avez utilisée pour l’installer.

Utiliser azd update (bêta)

La commande azd update détecte automatiquement comment azd a été installé initialement et délègue à la méthode de mise à jour appropriée.

Méthode d’installation Qu’est-ce que azd update fait
winget Exécute winget upgrade Microsoft.Azd
choco Exécute choco upgrade azd
Installer un script ou MSI (Windows) Fonctionne install-azd.ps1 avec sauvegarde et restauration automatiques
Installer le script (Linux/macOS) Exécute install-azd.sh
Homebrew Exécute brew upgrade --cask azure/azd/azd
.deb / .rpm Paquet Télécharge et remplace directement le binaire

Exécutez la commande suivante pour effectuer une mise à jour vers la dernière version stable :

azd update

Note

La azd update commande est actuellement en version bêta. En savoir plus sur la prise en charge des fonctionnalités alpha et bêta sur la page gestion des versions et stratégies de mise en production des fonctionnalités.

Changer les canaux de mise à jour

azd prend en charge deux canaux de mise à jour : stable (par défaut) et daily. Le changement de canal est pris en charge pour Homebrew et les installations basées sur des scripts. Si vous avez installé azd via winget ou choco, les builds quotidiennes ne sont pas disponibles par le biais de ces gestionnaires de packages , azd update affichent d’abord des conseils pour réinstaller via le script.

Pour basculer vers le daily canal et mettre à jour :

azd update --channel daily

Pour revenir au stable canal :

azd update --channel stable

Lorsque vous changez de canal, azd vous êtes invité à confirmer avant de continuer.

Utiliser votre gestionnaire de package ou installer un script

Vous pouvez également effectuer une mise à jour manuellement à tout moment à l’aide du même gestionnaire de package ou installer des commandes de script affichées dans les sections d’installation ci-dessus. Une fois azd obsolète, il affiche un message d’avertissement avec la commande de mise à jour applicable pour votre méthode d’installation.

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