Instalar ou atualizar a CLI do Azure Developer

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

Comece selecionando seu ambiente de desenvolvimento. Para mais informações sobre os prós e contras das diferentes escolhas de ambientes de desenvolvimento, consulte Azure Developers CLI (azd) supported environments.

Para cenários e instruções de instalação mais avançadas, consulte Azure Developers CLI Installer Scripts.

Nota: Quando instala azd, as seguintes ferramentas são instaladas no escopo de 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 azd

winget uninstall microsoft.azd

Observação

Nos 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 install azure/azd/azd

Se estiver a usar brew para atualizar azd a partir de uma versão que não foi instalada com brew, remova a versão existente de azd usando o script de desinstalação (se instalada na localização padrão) ou eliminando manualmente o binário azd. Isso instalará automaticamente a versão correta.

Atualização azd

brew upgrade --cask azure/azd/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 se instala azd, as seguintes ferramentas são instaladas no escopo de azd (ou seja, não sã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, 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 a funcionalidade azd ao ficheiro devcontainer.json no directório .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. Reconstrua e execute seu contêiner de desenvolvimento. No Visual Studio Code, use a paleta de comandos para executar o comando Reconstruir e Reabrir no Contentor de Desenvolvimento.

Instalação automática de extensões azd

A azd funcionalidade Dev Container suporta uma extensions opção para instalar automaticamente uma lista separada por vírgulas de azd extensões durante a construção do contentor. As extensões instaladas desta forma estão disponíveis assim que o contentor inicia, reduzindo a configuração manual e permitindo azd que comandos sejam executados com as extensões necessárias já instaladas.

Para instalar extensões automaticamente, adicione a extensions opção à azd entrada de funcionalidades no seu devcontainer.json ficheiro:

{
    "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 extensions valor é uma lista separada por vírgulas de azd nomes de extensões. A instalação ocorre durante a construção do contentor, por isso as extensões ficam prontas a ser usadas assim que o contentor começa. Depois de alterar a lista de extensões, use o comando Rebuild and ReOpen no Dev Container no Visual Studio Code para reconstruir o container com as extensões atualizadas.

Saiba mais sobre a funcionalidade Dev Container do 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)

Atualize o Azure Developer CLI

Podes atualizar azd usando o comando incorporado azd update (Beta) ou manualmente usando o mesmo método que usaste para instalar.

Usar azd update (Beta)

O azd update comando deteta como azd foi originalmente instalado 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
Script de instalação ou MSI (Windows) Funciona install-azd.ps1 com backup e restauro automáticos
Script de instalação (Linux/macOS) Executa install-azd.sh
Homebrew Corridas brew upgrade --cask azure/azd/azd
.deb / .rpm Pacote Descarrega e substitui diretamente o ficheiro 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 funcionalidades alfa e beta na página de versionamento de funcionalidades e estratégias de lançamento .

Alternar os canais de atualização

azd suporta dois canais de atualização: stable (por defeito) e daily. A comutação de canal é suportada para instalações baseadas em scripts e Homebrew. Se instalaste azd via winget ou choco, as compilações diárias não estão disponíveis através desses gestores de pacotes — azd update mostrarão orientações para reinstalar primeiro via script.

Para mudar para o daily canal e atualizar:

azd update --channel daily

Para voltar ao stable canal:

azd update --channel stable

Ao mudar de canal, azd solicita confirmação antes de prosseguir.

Use o seu gestor de pacotes ou script de instalação

Também pode atualizar manualmente a qualquer momento usando os mesmos comandos de gestor de pacotes ou script de instalação mostrados nas secções de instalação acima. Quando azd está desatualizado, aparece uma mensagem de aviso com o comando de atualização aplicável para o seu método de instalação.

Pedir ajuda

Para informações sobre como registar um bug, pedir ajuda ou propor uma nova funcionalidade para a Azure Developer CLI, por favor visite a página troubleshooting and support.

Próximos passos

Guia de início rápido - Selecionar e implantar um modelo azd

Quais são Azure modelos de CLI para Desenvolvedores?

Azure Perguntas Frequentes para Desenvolvedores

  • Last updated on