Installare o aggiornare l'interfaccia della riga di comando per sviluppatori Azure

Introduzione all'interfaccia della riga di comando per sviluppatori di Azure (azd)! Si inizierà a installare e imparare a eseguire azd.

Per iniziare, selezionare l'ambiente di sviluppo. Per altre informazioni sui vantaggi e sui svantaggi delle diverse opzioni relative all'ambiente di sviluppo, vedere Azure Gli ambienti supportati dall'interfaccia della riga di comando per sviluppatori (azd).

Per scenari di installazione e istruzioni più avanzati, vedere Azure Developer CLI Installer Scripts.

Nota: quando si installa azd, gli strumenti seguenti vengono installati all'interno dell'ambito azd (ovvero non sono installati a livello globale) e vengono rimossi se azd viene disinstallato:

  • Interfaccia della riga di comando GitHub
  • Interfaccia della riga di comando Bicep

Installare azd

winget install microsoft.azd

Aggiornamento azd

winget upgrade microsoft.azd

Disinstallare azd

winget uninstall microsoft.azd

Annotazioni

Su i Mac Apple Silicon (M1 e M2) azd richiede Rosetta 2. Se Rosetta 2 non è già installato, eseguire softwareupdate --install-rosetta dal terminale.

Il azd processo di installazione sceglierà automaticamente il file binario corretto per l'architettura del computer.

Installare azd

brew install azure/azd/azd

Se si usa brew per aggiornare azd da una versione non installata usando brew, rimuovere la versione esistente di azd usando lo script di disinstallazione (se installato nel percorso predefinito) o eliminando manualmente il file binario azd. Verrà installata automaticamente la versione corretta.

Aggiornamento azd

brew upgrade --cask azure/azd/azd

Disinstallare azd

brew uninstall azd

Installare azd

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

Aggiornamento azd

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

Quando si installa azd, gli strumenti seguenti vengono installati all'interno dell'ambito azd (ovvero non sono installati a livello globale) e vengono rimossi se azd viene disinstallato:

Disinstallare azd

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

Prerequisiti

Prima di iniziare a usare azd, assicurarsi di avere:

Installare azd in un contenitore di sviluppo

Un contenitore di sviluppo è un'immagine Docker che include tutti i prerequisiti necessari per eseguire un'app nel computer locale. Eseguire l'installazione azd come funzionalità nel contenitore di sviluppo seguendo questa procedura:

  1. Aggiungete la azd funzionalità al file devcontainer.json nella cartella .devcontainer nella directory principale del vostro modello.

    {
    "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. Ricompilare ed eseguire il contenitore di sviluppo. Usa la palette comandi in Visual Studio Code per eseguire il comando Rebuild and Reopen in Dev Container.

Installazione automatica di azd extensions

La azd funzionalità Contenitore di sviluppo supporta un'opzione extensions per installare automaticamente un elenco delimitato da virgole di azd estensioni durante la compilazione del contenitore. Le estensioni installate in questo modo sono disponibili non appena il contenitore viene avviato, riducendo la configurazione manuale e abilitando azd l'esecuzione dei comandi con le estensioni necessarie già installate.

Per installare automaticamente le estensioni, aggiungere l'opzione extensions alla voce di azd funzionalità nel devcontainer.json file:

{
    "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"
        }
    }
}

Il extensions valore è un elenco delimitato da virgole di nomi di azd estensione. L'installazione viene eseguita durante la compilazione del contenitore, quindi le estensioni sono pronte per l'uso non appena viene avviato il contenitore. Dopo aver modificato l'elenco delle estensioni, usare il comando Rebuild and Reopen in Dev Container in Visual Studio Code per ricompilare il contenitore con le estensioni aggiornate.

Altre informazioni sulla funzionalità azd Dev Container.

Verifica dell'installazione

Verificare che azd l'installazione sia stata completata correttamente eseguendo il azd version comando in un terminale:

azd version

azd stampa la versione corrente:

azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)

Aggiornare l'interfaccia della riga di comando per sviluppatori di Azure

È possibile eseguire l'aggiornamento azd usando il comando predefinito azd update (Beta) o manualmente usando lo stesso metodo usato per installarlo.

Usare azd update (beta)

Il azd update comando rileva come azd è stato originariamente installato e delega automaticamente al metodo di aggiornamento appropriato:

Metodo di installazione Che cosa azd update fa
winget Esegue winget upgrade Microsoft.Azd
choco Esegue choco upgrade azd
Installare script o pacchetto MSI (Windows) Viene eseguito install-azd.ps1 con backup e ripristino automatici
Installare lo script (Linux/macOS) Viene eseguito install-azd.sh
Homebrew Viene eseguito brew upgrade --cask azure/azd/azd
.deb / .rpm Pacchetto Scarica e sostituisce direttamente il file binario

Eseguire il comando seguente per eseguire l'aggiornamento alla versione stabile più recente:

azd update

Annotazioni

Il azd update comando è attualmente in versione beta. Altre informazioni sul supporto delle funzionalità alfa e beta sono disponibili nella pagina relativa al controllo delle versioni delle funzionalità e alla strategia di rilascio .

Cambiare i canali di aggiornamento

azd supporta due canali di aggiornamento: stable (impostazione predefinita) e daily. Il cambio di canale è supportato per le installazioni basate su script e Homebrew. Se hai installato azd tramite winget o choco, le compilazioni giornaliere non sono disponibili tramite questi gestori di pacchetti. azd update mostrerà prima le indicazioni per la reinstallazione tramite script.

Per passare al daily canale e aggiornare:

azd update --channel daily

Per tornare al stable canale:

azd update --channel stable

Quando si cambia canale, azd viene richiesta conferma prima di procedere.

Usa il gestore di pacchetti o lo script di installazione

È anche possibile aggiornare manualmente in qualsiasi momento usando lo stesso strumento di gestione pacchetti o i comandi di script di installazione illustrati nelle sezioni di installazione precedenti. Quando azd non è aggiornato, viene visualizzato un messaggio di avviso con il comando di aggiornamento applicabile per il metodo di installazione.

Richiedere assistenza

Per informazioni su come inviare un bug, richiedere assistenza o proporre una nuova funzionalità per l'interfaccia della riga di comando per sviluppatori di Azure, visitare la pagina troubleshooting e supporto.

Passaggi successivi

Avvio rapido: Selezionare e distribuire un modello azd

Cosa sono i modelli di Azure Developer CLI?

Domande frequenti Azure Developer CLI

  • Last updated on