Instalar a CLI clássica do AzureInstall the Azure classic CLI

Importante

Este tópico descreve como instalar a CLI clássica do Azure.This topic describes how to install the Azure classic CLI. A CLI clássica foi preterida e só deve ser usada com o modelo de implantação clássico.The classic CLI is deprecated and should only be used with the classic deployment model. Para todas as outras implantações, use a CLI do Azure.For all other deployments, use the Azure CLI.

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.Quickly install the Azure classic CLI to use a set of open-source shell-based commands for creating and managing resources in Microsoft Azure. Você tem várias opções para instalar essas ferramentas de plataforma cruzada em seu computador:You have several options to install these cross-platform tools on your computer:

  • 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.npm package - Run npm (the package manager for JavaScript) to install the Azure classic CLI package on your Linux distribution or OS. Requer Node.js e npm.Requires node.js and npm.
  • Instalador: baixe um instalador para facilitar a instalação no macOS ou no Windows.Installer - Download an installer for easy installation on macOS or Windows.
  • Contêiner do Docker: comece a usar a CLI clássica em um contêiner do Docker pronto para ser executado.Docker container - Start using the classic CLI in a ready-to-run Docker container. Requer um host do Docker.Requires a Docker host.

Para obter mais opções e um histórico, consulte o repositório do projeto no GitHub.For more options and background, see the project repository on 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.Once the Azure classic CLI is installed, connect with azure login and run the azure commands from your command-line interface (Bash, Terminal, Command prompt, and so on) to work with your Azure resources.

Opção 1: Instalar um pacote npmOption 1: Install an npm package

Para instalar a CLI clássica de um pacote npm, você precisa baixar e instalar os Node.js e npm mais recentes.To install the classic CLI from an npm package, make sure you have downloaded and installed the latest Node.js and npm. Em seguida, execute npm install para instalar o pacote azure-cli:Then, run npm install to install the azure-cli package:

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:On Linux distributions, you might need to use sudo to successfully run the npm command, as follows:

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.If you need to install or update Node.js and npm on your OS, we recommend that you install Node.js LTS version 4.x or later. Se você usar uma versão mais antiga, poderá obter erros de instalação.If you use an older version, you might get installation errors.

Se preferir, você também poderá baixar um arquivo tar das Versões do GitHub.If you prefer, you may also download a tar file from the GitHub releases. Em seguida, instale o pacote npm baixado da seguinte maneira (em distribuições Linux, talvez seja necessário usar sudo):Then, install the downloaded npm package as follows (on Linux distributions you might need to use sudo):

npm install -g <path to downloaded tar file>

Opção 2: Usar um instaladorOption 2: Use an installer

Se você usa um computador Windows ou Mac, há instaladores DMG e MSI disponíveis nas Versões do GitHub.If you use a Mac or Windows computer, DMG and MSI installers are available from GitHub releases.

Dica

No Windows, você também pode baixar o Web Platform Installer para instalar a CLI clássica.On Windows, you can also download the Web Platform Installer to install the classic CLI. Esse instalador dá a opção de instalar o SDK do Azure e outras ferramentas de linha de comando.This installer gives you the option to install additional Azure SDK and command-line tools.

Opção 3: Usar um contêiner do DockerOption 3: Use a Docker container

Se você tiver configurado seu computador como um host do Docker, execute a CLI clássica do Azure em um contêiner do Docker.If you have set up your computer as a Docker host, you can run the Azure classic CLI in a Docker container. Execute o seguinte comando (em distribuições Linux, talvez seja necessário usar sudo):Run the following command (on Linux distributions you might need to use sudo):

docker run -it microsoft/azure-cli:0.10.17

Executar comandos da CLI clássica do AzureRun Azure classic CLI commands

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).After the classic CLI is installed, run the azure command from your command-line user interface (Bash, Terminal, Command prompt, and so on). Por exemplo, para executar o comando de ajuda, digite o seguinte:For example, to run the help command, type the following:

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.On some Linux distributions, you may receive an error similar to /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.This error comes from recent installations of Node.js being installed at /usr/bin/nodejs. Para corrigi-lo, crie um link simbólico para /usr/bin/node executando este comando:To fix it, create a symbolic link to /usr/bin/node by running this command:

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:To see the version of the Azure classic CLI installed, type the following:

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.When you first use Azure classic CLI, you see a message asking if you want to allow Microsoft to collect usage information. A participação é voluntária.Participation is voluntary. Se optar por participar, você poderá parar a qualquer momento executando azure telemetry --disable.If you choose to participate, you can stop at any time by running azure telemetry --disable. Para habilitar a participação a qualquer momento, execute azure telemetry --enable.To enable participation at any time, run azure telemetry --enable.

Atualizar a CLI clássicaUpdate the classic CLI

A Microsoft pode lançar versões atualizadas da CLI clássica do Azure.Microsoft may release updated versions of the Azure classic CLI. Reinstale a CLI clássica usando o instalador do seu sistema operacional ou executando o contêiner do Docker mais recente.Reinstall the classic CLI using the installer for your operating system, or run the latest Docker container. 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).Or, if you have the latest Node.js and npm installed, update by typing the following (on Linux distributions you might need to use sudo).

npm update -g azure-cli

Ativar o recurso auto-completar com TABEnable tab completion

Há suporte à conclusão de tabulação de comandos da CLI clássica para Mac e Linux.Tab completion of classic CLI commands is supported for Mac and Linux.

Para habilitá-lo no zsh, execute:To enable it in zsh, run:

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

Para habilitá-lo no bash, execute:To enable it in bash, run:

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

Próximas etapasNext steps