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 utilizada com o modelo de implementação clássica. Relativamente a todas as outras implementações, utilize a CLI do Azure.

Instale rapidamente a CLI clássica do Azure para utilizar um conjunto de comandos de código aberto baseados na shell para criar e gerir recursos no Microsoft Azure. Tem várias opções para instalar estas ferramentas de plataformas no seu computador:

  • pacote npm - execute o npm (o gestor de pacotes do JavaScript) para instalar o pacote da CLI clássica do Azure no seu SO ou na sua distribuição de Linux. Requer node.js e npm.
  • Instalador - transfira um instalador para uma instalação simples em macOS ou Windows.
  • Contentor do Docker - comece a utilizar a CLI clássica num contentor do Docker pronto a executar. Requer um anfitrião Docker.

Para obter mais opções e informações, veja o repositório do projeto no GitHub.

Assim que a CLI clássica do Azure estiver instalada, ligue-a a azure login e execute os comandos azure a partir da sua interface de linha de comandos (Bash, Terminal, Linha de comandos e assim sucessivamente) para trabalhar com os recursos do Azure.

Opção 1: Instalar um pacote npm

Para instalar a CLI clássica a partir de um pacote npm, certifique-se de que transferiu e instalou o Node.js e o npm mais recentes. Em seguida, execute npm install para instalar o pacote azure-cli:

npm install -g azure-cli

Nas distribuições do Linux, poderá ter de utilizar sudo para executar o comando npm com êxito, da seguinte forma:

sudo npm install -g azure-cli

Nota

Se precisar de instalar ou atualizar o Node.js e o npm no seu SO, recomendamos que instale a versão 4.x ou posterior do Node.js LTS. Se utilizar uma versão mais antiga, poderá obter erros de instalação.

Se preferir, também pode transferir um ficheiro tar a partir das versões do GitHub. Em seguida, instale o pacote npm transferido da seguinte forma (nas distribuições do Linux, poderá ter de utilizar sudo):

npm install -g <path to downloaded tar file>

Opção 2: Utilizar um instalador

Se utilizar um computador Mac ou Windows, estão disponíveis os instaladores DMG e MSI nas versões do GitHub.

Dica

No Windows, também pode transferir o Instalador de Plataforma Web para instalar a CLI clássica. Este instalador oferece-lhe a opção de instalar o SDK do Azure e ferramentas de linha de comandos adicionais.

Opção 3: Utilizar um contentor do Docker

Se tiver configurado o computador como um anfitrião Docker, pode executar a CLI clássica do Azure num contentor do Docker. Execute o seguinte comando (em distribuições do Linux, poderá ter de utilizar 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 estiver instalada, execute o comando azure na sua interface de utilizador da linha de comandos (Bash, Terminal, Linha de comandos e assim sucessivamente). Por exemplo, para executar o comando de ajuda, escreva o seguinte:

azure help

Nota

Em algumas distribuições do Linux, poderá receber um erro semelhante a /usr/bin/env: ‘node’: No such file or directory. Este erro provém de instalações recentes do Node.js que são instaladas em /usr/bin/nodejs. Para corrigir, crie uma ligação simbólica para /usr/bin/node ao executar o comando:

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

Para ver a versão da CLI clássica do Azure instalada, escreva o seguinte:

azure --version

Nota

Quando utilizar a CLI clássica do Azure pela primeira vez, verá uma mensagem a perguntar se pretende permitir que a Microsoft recolha informações de utilização. A participação é voluntária. Se optar por participar, pode parar em qualquer momento ao executar azure telemetry --disable. Para ativar a participação em qualquer altura, execute azure telemetry --enable.

Atualizar a CLI clássica

A Microsoft poderá lançar versões atualizadas da CLI clássica do Azure. Reinstale a CLI clássica com o instalador do seu sistema operativo ou execute o contentor mais recente do Docker. Ou, se tiver o Node.js e o npm mais recentes instalados, escreva o seguinte (em distribuições do Linux poderá ter de utilizar sudo) para atualizar.

npm update -g azure-cli

Ativar a conclusão do separador

A conclusão do separador de comandos da CLI clássica é suportada em Mac e Linux.

Para o ativar no zsh, execute:

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

Para o ativar no bash, execute:

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

Passos seguintes