Condividi tramite

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 a riga di comando di 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 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. In Visual Studio Code usare la palette comandi per eseguire il comando Ricostruisci e riapri nel contenitore di sviluppo.

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

Quando si usa una versione non aggiornata di azd, verrà visualizzato un avviso per eseguire l'aggiornamento alla versione più recente. Seguire le istruzioni nell'avviso per eseguire l'aggiornamento alla versione più recente.

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