Compartilhar via


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 os ambientes com suporte da CLI do Desenvolvedor do Azure (azd).

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

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:

Instalar azd

winget install microsoft.azd

Atualização azd

winget upgrade microsoft.azd

Desinstalar azd

winget uninstall microsoft.azd

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 tap azure/azd && brew install azd

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

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 azd

Desinstalar 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

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:

Desinstalar azd

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

Pré-requisitos

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

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:

  1. 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...
    } 
    
  2. Recompile e execute o contêiner de desenvolvimento. No Visual Studio Code, use a paleta de comandos para executar o comando Recriar e Reabrir no Contêiner de Desenvolvimento.

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

Ao trabalhar com uma versão desatualizada, azdvocê 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 arquivar um bug, solicitar ajuda ou propor um novo recurso para a CLI do Desenvolvedor do Azure, visite a página solução de problemas e suporte.

Próximas etapas