Instalar ou atualizar a Azure Developer CLI

  • Artigo

Bem-vindo ao Azure Developer CLI (azd)! Vamos começar a instalar e aprender a executar o 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 com suporte do Azure Developer CLI (azd).

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

Observação: ao instalar o azd, as seguintes ferramentas são instaladas no escopo azd (o que significa que não são instaladas globalmente) e são removidas se o azd for desinstalado:

Instalar azd

winget install microsoft.azd

Atualização azd

winget upgrade microsoft.azd

Desinstalar o azd

winget uninstall microsoft.azd

Observação

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

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

Instalar azd

brew tap azure/azd && brew install azd

O comando brew tap azure/azd só precisa ser executado uma vez para configurar o toque em brew.

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

Atualização azd

brew upgrade azd

Desinstalar o azd

brew uninstall azd

Instalar azd

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

Atualização azd

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

Ao instalar o azd, as seguintes ferramentas são instaladas no escopo azd (o que significa que não são instaladas globalmente) e são removidas se o azd for desinstalado:

Desinstalar o azd

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

Pré-requisitos

Antes de começar a usar o azd, certifique-se de ter:

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 o azd como um recurso em seu contêiner de desenvolvimento por meio das seguintes etapas:

  1. Adicione o recurso azd ao arquivo devcontainer.json na pasta .devcontainer na raiz do seu 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...
}

  2. Recompile e execute seu contêiner de desenvolvimento. No Visual Studio Code, use a paleta de comandos para executar o comando Recompilar e reabrir no contêiner de desenvolvimento.

Verificar a instalação

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

azd version

azd imprime a versão atual:

azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)

Atualizar o Azure Developer CLI

Ao trabalhar com uma versão desatualizada do azd, você verá um aviso para atualizar para a versão mais recente. Siga as instruções no aviso para atualizar para a versão mais recente.

Solicitar ajuda

Para obter informações sobre como registrar um bug, solicitar ajuda ou propor um novo recurso para o Azure Developer CLI, acesse a página de solução de problemas e suporte.

Próximas etapas

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

O que são modelos do Azure Developer CLI?

Perguntas frequentes da Azure Developer CLI