Instalar a CLI clássica do Azure

  • Artigo

Importante

Este tópico descreve como instalar a CLI clássica do Azure. A CLI clássica foi preterida e só deve ser usada com o modelo de implantação clássico. Para todas as outras implantações, use a CLI do Azure.

Instale rapidamente a CLI clássica do Azure para usar comandos de software livre baseados em shell a fim de criar e gerenciar recursos no Microsoft Azure. Você tem várias opções para instalar essas ferramentas de plataforma cruzada em seu computador:

  • Pacote npm: execute o npm (o gerenciador de pacotes para JavaScript) para instalar o pacote da CLI clássica do Azure em sua distribuição Linux ou sistema operacional. Requer Node.js e npm.
  • Instalador: baixe um instalador para facilitar a instalação no macOS ou no Windows.
  • Contêiner do Docker: comece a usar a CLI clássica em um contêiner do Docker pronto para ser executado. Requer um host do Docker.

Para obter mais opções e um histórico, consulte o repositório do projeto no GitHub.

Quando a CLI clássica do Azure estiver instalada conecte-a com azure login e execute os comandosazure na interface de linha de comando (Bash, Terminal, Prompt de comando e assim por diante) para trabalhar com os recursos do Azure.

Opção 1: Instalar um pacote npm

Para instalar a CLI clássica de um pacote npm, você precisa baixar e instalar os Node.js e npm mais recentes. Em seguida, execute npm install para instalar o pacote azure-cli:

npm install -g azure-cli

Em distribuições Linux, talvez seja necessário usar sudo para executar o comando npm com êxito, da seguinte forma:

sudo npm install -g azure-cli

Observação

Se você precisa instalar ou atualizar o Node.js e o npm em seu sistema operacional, recomendamos que você instale o Node.js LTS versão 4.x ou posterior. Se você usar uma versão mais antiga, poderá obter erros de instalação.

Se preferir, você também poderá baixar um arquivo tar das Versões do GitHub. Em seguida, instale o pacote npm baixado da seguinte maneira (em distribuições Linux, talvez seja necessário usar sudo):

npm install -g <path to downloaded tar file>

Opção 2: Usar um instalador

Se você usa um computador Windows ou Mac, há instaladores DMG e MSI disponíveis nas Versões do GitHub.

Dica

No Windows, você também pode baixar o Web Platform Installer para instalar a CLI clássica. Esse instalador dá a opção de instalar o SDK do Azure e outras ferramentas de linha de comando.

Opção 3: Usar um contêiner do Docker

Se você tiver configurado seu computador como um host do Docker, execute a CLI clássica do Azure em um contêiner do Docker. Execute o seguinte comando (em distribuições Linux, talvez seja necessário usar sudo):

docker run -it mcr.microsoft.com/azure-cli:0.10.14

Executar comandos da CLI clássica do Azure

Quando a CLI clássica do Azure estiver instalada, execute o comando azure na interface do usuário de linha de comando (Bash, Terminal, Prompt de comando e assim por diante). Por exemplo, para executar o comando de ajuda, digite o seguinte:

azure help

Observação

Em algumas distribuições Linux, você poderá receber um erro semelhante a /usr/bin/env: ‘node’: No such file or directory. Esse erro ocorre quando instalações recentes do Node.js são instaladas em /usr/bin/nodejs. Para corrigi-lo, crie um link simbólico para /usr/bin/node executando este comando:

sudo ln -s /usr/bin/nodejs /usr/bin/node

Para ver a versão da CLI clássica do Azure que você instalou, digite o seguinte:

azure --version

Observação

Ao usar a CLI clássica do Azure pela primeira vez, você verá uma mensagem perguntando se deseja permitir que a Microsoft colete informações de uso. A participação é voluntária. Se optar por participar, você poderá parar a qualquer momento executando azure telemetry --disable. Para habilitar a participação a qualquer momento, execute azure telemetry --enable.

Atualizar a CLI clássica

A Microsoft pode lançar versões atualizadas da CLI clássica do Azure. Reinstale a CLI clássica usando o instalador do seu sistema operacional ou executando o contêiner do Docker mais recente. Ou, caso tenha o Node.js e o npm mais recentes instalados, atualize-os digitando o que é mostrado abaixo (em distribuições Linux, talvez seja necessário usar sudo).

npm update -g azure-cli

Ativar o recurso auto-completar com TAB

Há suporte à conclusão de tabulação de comandos da CLI clássica para Mac e Linux.

Para habilitá-lo no zsh, execute:

echo '. <(azure --completion)' >> .zshrc

Para habilitá-lo no bash, execute:

azure --completion >> ~/azure.completion.sh
echo 'source ~/azure.completion.sh' >> ~/.bash_profile

Próximas etapas