Instalar ou atualizar a CLI do Azure Developer

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

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 suportados pela CLI do Desenvolvedor do Azure (azd).

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

Nota: Quando você instala azdo , as seguintes ferramentas são instaladas dentro azd do escopo (o que significa que não são instaladas globalmente) e são removidas se azd for desinstalado:

Instalar azd

winget install microsoft.azd

Atualizar azd

winget upgrade microsoft.azd

Desinstalar azd

winget uninstall microsoft.azd

Nota

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 azd processo de instalação escolherá automaticamente o binário correto para a arquitetura da sua máquina.

Instalar azd

brew tap azure/azd && brew install azd

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

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

Atualizar azd

brew upgrade azd

Desinstalar azd

brew uninstall azd

Instalar azd

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

Atualizar azd

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

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

Desinstalar azd

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

Pré-requisitos

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

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 sua máquina local. Instale azd como um recurso em seu contêiner de desenvolvimento através 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. Reconstrua e execute seu contêiner de desenvolvimento. No Visual Studio Code, use a paleta de comandos para executar o comando Rebuild and Reopen in Dev Container.

Atualizando a CLI do Azure Developer

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.

Pedir 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 de solução de problemas e suporte .

Próximos passos