Instalar ou atualizar a CLI do Desenvolvedor do Azure

Bem-vindo à CLI do Desenvolvedor do Azure (azd)! Vamos começar a instalar e aprender a executar azd.

Comece selecionando seu ambiente de desenvolvimento. Para obter mais informações sobre os prós e contras das diferentes opções de ambiente de desenvolvimento, consulte ambientes compatíveis do Azure com a CLI do Desenvolvedor (azd).

Para obter mais instruções e cenários de instalação mais avançados, consulte Azure Scripts do Instalador da CLI do Desenvolvedor.

Observação: quando você instala azd, as seguintes ferramentas são instaladas no azd escopo (o que significa que elas não estão instaladas globalmente) e são removidas se o azd for desinstalado:

A CLI do GitHub
O Bicep CLI

Instalar `azd`

winget install microsoft.azd

Atualização `azd`

winget upgrade microsoft.azd

Desinstalar `azd`

winget uninstall microsoft.azd

Instalar `azd`

choco install azd

Atualização `azd`

choco upgrade azd

Desinstalar `azd`

choco uninstall azd

Instalar `azd`

O script de instalação baixa e instala o pacote MSI no computador com parâmetros padrão.

powershell -ex AllSigned -c "Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression"

Atualização `azd`

powershell -ex AllSigned -c "Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression"

Desinstalar `azd`

Usar o script de desinstalação para remover azd deixa alguns itens para trás no computador. Em vez disso, para a versão 0.5.0-beta.1 e posterior:

Pesquise Add ou remova programas em Windows.
Localize Azure Dev CLI e clique nos três pontos para abrir o menu de opções.
Selecione Desinstalar.

Observação

O suporte para Windows Arm64 está atualmente em Alpha. Visite a página de versionamento de funcionalidades e estratégia de lançamento para obter mais informações.

A versão arm64 do azd está disponível para download diretamente na página de versão GitHub. Atualmente, não há suporte direto para instaladores do gerenciador de pacotes ou outros canais.

Instalar `azd`

Observação

Se o computador já tiver a versão Windows x86_64 de azd instalada, primeiro desinstale a versão x86_64 para impedir que atualizações ou reparos MSI gravem sobre o executável Arm64.

Na página de lançamento do GitHub, baixe o arquivo azd-windows-arm64-alpha.zip mais recente.
Extraia o arquivo azd-windows-arm64-alpha.zip e copie o executável azd-windows-amd64.exe para o local padrão azdC:\Users\<username>\AppData\Local\Programs\Azure Dev CLI em seu dispositivo.
Adicione uma entrada à variável de ambiente PATH em seu dispositivo para apontar para o arquivo extraído em C:\Users\<username>\AppData\Local\Programs\Azure Dev CLI\azd-windows-amd64.exe.

Atualização `azd`

Na página de lançamentos do GitHub, baixe o arquivo azd-windows-arm64-alpha.zip mais recente.
Extraia o arquivo azd-windows-arm64-alpha.zip e copie o executável azd-windows-amd64.exe para o local padrão azdC:\Users\<username>\AppData\Local\Programs\Azure Dev CLI em seu dispositivo para substituir o executável existente.
Verifique se você tem uma variável de ambiente PATH em seu dispositivo que aponta para o arquivo extraído em C:\Users\<username>\AppData\Local\Programs\Azure Dev CLI\azd-windows-amd64.exe.

Desinstalar `azd`

Remova o executável azd-windows-amd64.exe do local padrão azdC:\Users\<username>\AppData\Local\Programs\Azure Dev CLI em seu dispositivo. Se você tiver instalado azd em um local diferente, precisará excluí-lo de lá.
Remova a PATH variável de ambiente que você adicionou para apontar para o local de azd instalação.

Homebrew (recomendado)
Roteiro

Observação

Nos Macs com Apple Silicon (M1 e M2) azd requer Rosetta 2. Se Rosetta 2 ainda não estiver instalado, execute softwareupdate --install-rosetta a partir do terminal.

O azd processo de instalação escolherá automaticamente o binário correto para a arquitetura do computador.

Instalar `azd`

brew install azure/azd/azd

Se você estiver usando brew para atualizar azd de uma versão não instalada usando brew, remova a versão existente de azd usando o script de desinstalação (se instalado no local padrão) ou deletando o binário azd manualmente. Isso instalará automaticamente a versão correta.

Atualização `azd`

brew upgrade --cask azure/azd/azd

Desinstalar `azd`

brew uninstall azd

Observação

O azd processo de instalação escolherá automaticamente o binário correto para a arquitetura do computador.

O script de instalação pode ser usado para instalar a versão correta de azd no escopo da máquina.

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

Atualização `azd`

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

Desinstalar `azd`

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

Instalar `azd`

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

Atualização `azd`

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

Quando você instala azd, as seguintes ferramentas são instaladas no azd escopo (o que significa que elas não estão instaladas globalmente) e são removidas se o azd for desinstalado:

A CLI do Git
O Bicep CLI

Desinstalar `azd`

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

As versões da CLI do Desenvolvedor do Azure lançam pacotes assinados .deb e .rpm para GitHub Releases. Para instalar ou atualizar, baixe o arquivo apropriado da versão GitHub e execute o comando apropriado para instalar o pacote:**

Instalar ou atualizar `.deb` pacote para `azd`

Você pode instalar o .deb pacote usando apt-get:

curl -fSL https://github.com/Azure/azure-dev/releases/download/azure-dev-cli_<version>/azd_<version>_amd64.deb -o azd_<version>_amd64.deb
apt update 
apt install ./azd_<version>_amd64.deb -y

Desinstalar o pacote `.deb` para `azd`

apt remove -y azd

Observação

Talvez seja necessário usar sudo ao executar apt.

As versões da CLI do Desenvolvedor do Azure lançam pacotes assinados .deb e .rpm para Releases do GitHub. Para instalar, baixe o arquivo apropriado na versão GitHub e execute o comando apropriado para instalar o pacote:**

Instale o pacote `.rpm` para `azd`

Você pode instalar o .rpm pacote usando yum install:

curl -fSL https://github.com/Azure/azure-dev/releases/download/azure-dev-cli_<version>/azd-<version>-1.x86_64.rpm -o azd-<version>-1.x86_64.rpm
yum install -y azd-<version>-1.x86_64.rpm

Desinstalar o pacote `.rpm` para `azd`

yum remove -y azd

Observação

Talvez seja necessário usar sudo ao executar yum.

Pré-requisitos

Antes de começar a usar azd, verifique se você tem:

Instalado:
- Docker Desktop (outras opções em breve.)
- Extensão de contêineres do VS Code - Remoto
Uma conta Azure com uma assinatura ativa. Crie um gratuitamente.

Instalar `azd` em um contêiner de desenvolvimento

Um contêiner de desenvolvimento é uma imagem do Docker que inclui todos os pré-requisitos necessários para executar um aplicativo em seu computador local. Instale azd como um recurso em seu contêiner de desenvolvimento por meio das seguintes etapas:

Adicione o azd recurso ao devcontainer.json arquivo na .devcontainer pasta na raiz do modelo.

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

Recompile e execute o contêiner de desenvolvimento. Em Visual Studio Code, use a paleta de comandos para executar o comando Rebuild e Reabrir no Contêiner de Desenvolvimento.

Instalar automaticamente extensões do azd

O azd Recurso de Contêiner de Desenvolvimento dá suporte a uma extensions opção para instalar automaticamente uma lista separada por vírgulas de azd extensões durante o build do contêiner. As extensões instaladas dessa forma estão disponíveis assim que o contêiner é iniciado, reduzindo a instalação manual e permitindo azd que os comandos sejam executados com as extensões necessárias já instaladas.

Para instalar automaticamente as extensões, adicione a opção extensions à entrada do recurso azd em seu arquivo devcontainer.json.

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

O valor extensions é uma lista de nomes de extensão azd separados por vírgulas. A instalação ocorre durante o build do contêiner, de modo que as extensões estejam prontas para uso assim que o contêiner for iniciado. Depois de alterar a lista de extensões, use o comando Rebuild e Reabra no Contêiner de Desenvolvimento em Visual Studio Code para recompilar o contêiner com as extensões atualizadas.

Saiba mais sobre o recurso de contêiner de desenvolvimento azd.

Verificar a instalação

Verifique se a azd instalação foi concluída com êxito executando o azd version comando em um terminal:

azd version

azd imprime a versão atual:

azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)

Atualizar a CLI do Desenvolvedor do Azure

Você pode atualizar azd usando o comando embutido azd update (Beta) ou manualmente usando o mesmo método usado para instalá-lo.

Usar `azd update` (Beta)

O azd update comando detecta como azd foi instalado originalmente e delega automaticamente ao método de atualização apropriado:

Método de instalação	O que `azd update` faz
`winget`	Executa `winget upgrade Microsoft.Azd`
`choco`	Executa `choco upgrade azd`
Instalar script ou MSI (Windows)	É executado `install-azd.ps1` com backup e restauração automáticos
Instalar script (Linux/macOS)	Executa `install-azd.sh`
Homebrew	Executa `brew upgrade --cask azure/azd/azd`
`.deb` / `.rpm` Pacote	Faz o download diretamente e substitui o binário.

Execute o seguinte comando para atualizar para a versão estável mais recente:

azd update

Observação

O azd update comando está atualmente em Beta. Leia mais sobre o suporte a recursos alfa e beta na página de versionamento de recursos e estratégia de lançamento.

Alternar canais de atualização

azd dá suporte a dois canais de atualização: stable (padrão) e daily. Há suporte para alternância de canal para instalações baseadas em script e Homebrew. Se você instalou azd por meio de winget ou choco, as versões diárias não estão disponíveis por meio desses gerenciadores de pacotes — azd update mostrará diretrizes para reinstalar primeiro por meio do script.

Para alternar para o daily canal e atualizar:

azd update --channel daily

Para alternar para o canal stable:

azd update --channel stable

Ao alternar canais, azd solicita confirmação antes de continuar.

Usar o gerenciador de pacotes ou instalar o script

Você também pode atualizar manualmente a qualquer momento usando o mesmo gerenciador de pacotes ou instalar comandos de script mostrados nas seções de instalação acima. Quando azd estiver desatualizado, ele exibirá uma mensagem de aviso com o comando de atualização aplicável para o método de instalação.

Solicitar ajuda

Para obter informações sobre como arquivar um bug, solicitar ajuda ou propor um novo recurso para a CLI do Desenvolvedor do Azure, visite a página troubleshooting e suporte.

Próximas etapas

Início Rápido – Selecionar e implantar um modelo azd

O que são modelos da CLI do Desenvolvedor Azure?

Perguntas frequentes sobre Azure Developer CLI

Comentários

Esta página foi útil?

Last updated on 2026-04-21

Instalar ou atualizar a CLI do Desenvolvedor do Azure

Instalar azd

Atualização azd

Desinstalar azd

Instalar azd

Atualização azd

Desinstalar azd

Instalar azd

Atualização azd

Desinstalar azd

Pré-requisitos

Instalar azd em um contêiner de desenvolvimento

Instalar automaticamente extensões do azd

Verificar a instalação

Atualizar a CLI do Desenvolvedor do Azure

Usar azd update (Beta)

Alternar canais de atualização

Usar o gerenciador de pacotes ou instalar o script

Solicitar ajuda

Próximas etapas

Comentários

Recursos adicionais

Instalar `azd`

Atualização `azd`

Desinstalar `azd`

Instalar `azd`

Atualização `azd`

Desinstalar `azd`

Instalar `azd`

Atualização `azd`

Desinstalar `azd`

Instalar `azd` em um contêiner de desenvolvimento

Usar `azd update` (Beta)