O que é a CLI do Azure?

4 minutos

A CLI (Interface de Command-Line do Azure) é uma ferramenta de linha de comando de plataforma cruzada projetada para se conectar ao Azure e executar comandos administrativos em recursos do Azure. Ele fornece uma interface consistente e programável para gerenciar sua infraestrutura de nuvem, quer você esteja trabalhando interativamente em um terminal ou automatizando tarefas por meio de scripts.

O que é a CLI do Azure?

A CLI do Azure permite:

Execute comandos interativamente: Digite comandos em um prompt de terminal e veja os resultados imediatos.
Automatize através de scripts: Combine comandos em Bash, PowerShell ou outros shell scripts para tarefas repetitivas.
Gerencie todos os serviços do Azure: Crie, configure, exclua e monitore recursos do Azure usando sintaxe consistente.
Trabalhe em qualquer lugar: Instale em contêineres Linux, macOS, Windows, Docker ou use o Azure Cloud Shell.

Opções de instalação e execução

Suporte à plataforma:

Platform	Opções do Shell	Método de Instalação
Linux	Bash, PowerShell 7	Gerenciador de pacotes (apt, yum) ou script
macOS	Bash, Zsh, PowerShell 7	Homebrew ou instalador
Windows	cmd.exe, PowerShell, PowerShell 7	Programa de instalação MSI
Docker	Bash	Imagem de contêiner pré-construída
Azure Cloud Shell	Bash, PowerShell	Built-in (sem necessidade de instalação)

Ambientes recomendados:

Azure Cloud Shell: Pré-instalado com CLI do Azure sempre atualizado e autenticação configurada automaticamente.
Bash no Linux/macOS: Shell natural para CLI do Azure com excelentes recursos de script.
PowerShell 7: PowerShell multiplataforma que oferece experiência consistente em todos os sistemas operacionais.
Prompt de comando do Windows (cmd.exe): Shell básico do Windows para execução simples de comandos.

Os detalhes da instalação e os padrões de execução de comandos são explicados em profundidade mais adiante neste módulo. Antes de continuar, vamos entender a arquitetura da CLI do Azure e a estrutura de comandos.

Tipos de referência da CLI do Azure

Os comandos da CLI do Azure são organizados em duas categorias: referências principais e extensões. Entender a diferença ajuda você a gerenciar sua instalação da CLI do Azure e acessar os recursos mais recentes.

Referências principais

As referências principais são comandos permanentes internos que são instalados automaticamente com a CLI do Azure:

Sempre disponível: Instalar com a CLI do Azure; Nenhuma configuração adicional é necessária.
Pronto para produção: Comandos estáveis e bem testados para o gerenciamento diário do Azure.
Atualizado automaticamente: Ao usar o Azure Cloud Shell, as referências principais são sempre atuais.
Cobertura abrangente: Inclui comandos para a maioria dos serviços do Azure e tarefas comuns.

Exemplos de grupos de referência principais:

az account - Gerenciar assinaturas do Azure.
az group - Gerenciar grupos de recursos.
az storage - Gerenciar contas de armazenamento do Azure.
az vm - Gerenciar máquinas virtuais.
az network - Gerenciar recursos de rede.

Extensions

As extensões fornecem funcionalidade opcional e especializada que é executada como comandos da CLI do Azure:

Instalação opt-in: Não incluído por padrão; instale quando necessário.
Aceda às novas funcionalidades: Obtenha recursos de visualização e experimentais do Azure antes que eles se tornem GA (Geralmente Disponíveis).
Atualizações flexíveis: Atualize as extensões independentemente da CLI principal do Azure.
Prompt automático: A CLI do Azure solicita que você instale uma extensão na primeira utilização.

Casos de uso comuns para extensões:

Funcionalidades de pré-visualização para serviços do Azure.
Ferramentas especializadas para cenários específicos (por exemplo, Azure IoT, Azure Machine Learning).
Comandos fornecidos pelo fornecedor para integrações de terceiros.

Exemplo: Na primeira vez que você executa um comando de extensão, a CLI do Azure solicita:

$ az aks create --resource-group myResourceGroup --name myAKSCluster
The command requires the extension aks-preview. Do you want to install it now? (Y/n): Y

Status de referência da CLI do Azure

Os comandos da CLI do Azure têm estágios de ciclo de vida que indicam sua estabilidade e nível de suporte. O status (não o tipo) determina se um comando está pronto para produção.

Três categorias de status

Situação	Estabilidade	Utilização na Produção	Nível de Suporte
GA (Geralmente disponível)	Permanente	Yes	Suporte completo da Microsoft
Pré-visualização Pública	Pode mudar com base no feedback	Utilizar com precaução	Sujeito aos Termos de Visualização do Azure
preterido	Será removido	Não	Migrar para substituição

Detalhes do status:

GA (Geralmente disponível):
- Comandos estáveis para uso em produção.
- Alterações disruptivas apenas em atualizações de versões principais.
- Suporte completo da Microsoft e cobertura de SLA.
- Recomendado para cargas de trabalho de produção.
Visualização pública:
- Novos recursos disponíveis para testes e feedback.
- Pode ter alterações disruptivas sem aviso prévio.
- Suporte limitado; relatar problemas através do GitHub ou canais de feedback.
- Teste em ambientes de desenvolvimento antes do uso em produção.
Preterido:
- Comando agendado para remoção em versões futuras.
- Geralmente substituído por um comando mais novo e melhor.
- Caminho de migração fornecido na documentação.
- Evite usar em novos scripts ou automação.

Importante: Ambos os comandos core e extension podem ter qualquer status. Um comando núcleo pode estar em pré-visualização e um comando de extensão pode estar em Disponibilidade Geral (GA).

Padrão de referência da CLI do Azure

A CLI do Azure usa uma estrutura de comandos consistente e hierárquica que facilita a previsão e a lembrança de comandos. Depois de entender o padrão, você pode trabalhar com qualquer serviço do Azure.

Estrutura de comando

Padrão de sintaxe:

az <reference-group> <subgroup> <command> --<parameter> <value>

Discriminação dos componentes:

Componente	Description	Example
az	Comando base (sempre obrigatório)	`az`
Grupo de referência	Serviço ou categoria do Azure	`account`, `group`, `storage`, `vm`
Subgrupo	Tipo de recurso específico (opcional)	`blob`, `container`, `disk`
Comando	Ação a executar	`create`, `list`, `delete`, `show`
Parameter	Opções que modificam o comportamento	`--name`, `--resource-group`, `--location`
Value	Dados fornecidos ao parâmetro	`myStorageAccount`, `eastus`

Exemplo prático: Alterar a subscrição do Azure

Cenário: Mude sua assinatura padrão do Azure.

Detalhamento de comando:

az account set --subscription "my subscription name"

Grupo de referência:az account (gerencia assinaturas do Azure).
Comando:set (altera a subscrição ativa).
Parâmetro:--subscription (especifica qual assinatura).
Valor do parâmetro:"my subscription name" (o nome ou ID da sua subscrição).

Mais exemplos de comandos

Crie um grupo de recursos:

az group create --name myResourceGroup --location eastus

Grupo de referência:az group
Comando: create
Parâmetros:--name (nome do grupo de recursos), --location (região do Azure)

Listar contas de armazenamento:

az storage account list --resource-group myResourceGroup --output table

Grupo de referência:az storage
Subgrupo:account
Comando: list
Parâmetros:--resource-group (filtrar por grupo), --output (formatar resultados)

Reinicie uma máquina virtual:

az vm restart --name myVM --resource-group myResourceGroup

Grupo de referência:az vm
Comando: restart
Parâmetros:--name (nome da VM), --resource-group (contendo grupo)

Dica de reconhecimento de padrões: Os comandos seguem padrões de linguagem natural. Se quiser "criar uma conta de armazenamento em grupo de recursos", use az storage account create --resource-group.

Executando comandos da CLI do Azure

A CLI do Azure dá suporte a dois modos de execução: uso interativo de linha de comando e execução automatizada de scripts. Escolha a abordagem que melhor se adapta ao seu fluxo de trabalho.

Execução interativa

O modo interativo permite digitar comandos em um prompt de terminal e ver resultados imediatos. Esta abordagem é ideal para:

Aprendendo comandos e sintaxe da CLI do Azure.
Explorando os recursos do Azure e suas propriedades.
Tarefas rápidas únicas (criação de um recurso de teste, verificação de status).
Solução de problemas e depuração.

Como funciona:

Abra seu shell preferido (Bash, PowerShell, cmd.exe, Azure Cloud Shell).
Digite o comando Azure CLI no terminal.
Pressione Enter para executar.
Veja os resultados imediatamente.

Exemplo: Reinicie uma máquina virtual interativamente:

az vm restart --resource-group MyResourceGroup --name MyVm

Fluxo de trabalho interativo:

# Check current subscription
$ az account show --output table

# List all resource groups
$ az group list --output table

# Create a storage account
$ az storage account create --name mystorageacct --resource-group myRG --location eastus

Execução com script

O modo de script combina vários comandos da CLI do Azure em um arquivo de script para automação. Esta abordagem é essencial para:

Tarefas repetitivas (criação diária de ambientes de desenvolvimento).
Operações complexas em várias etapas (implantação de aplicativos inteiros).
Cadeias de CI/CD (implantações automatizadas).
Implementações de Infraestrutura como Código (IaC).

Como funciona:

Escreva comandos da CLI do Azure em um arquivo de script (.sh para Bash, .ps1 para PowerShell).
Adicione variáveis, loops e lógica condicional conforme necessário.
Torne o script executável (Bash: chmod +x script.sh).
Execute o script com parâmetros.

Exemplo: Script Bash que cria várias contas de armazenamento:

#!/bin/bash
# File: myScriptFile.sh

resourceGroup=$1
location="eastus"
accountCount=3

for i in $(seq 1 $accountCount); do
    accountName="storage${i}${RANDOM}"
    echo "Creating storage account: $accountName"
    az storage account create \
        --name $accountName \
        --resource-group $resourceGroup \
        --location $location \
        --sku Standard_LRS
done

Execute o script:

# Make script executable
chmod +x myScriptFile.sh

# Run script with resource group parameter
./myScriptFile.sh myResourceGroupName

Exemplo de script do PowerShell:

# File: myScript.ps1

param (
    [Parameter(Mandatory=$true)]
    [string]$ResourceGroupName
)

$location = "eastus"
$storageCount = 3

for ($i = 1; $i -le $storageCount; $i++) {
    $storageAccount = "storage$i$(Get-Random)"
    Write-Host "Creating storage account: $storageAccount"
    az storage account create `
        --name $storageAccount `
        --resource-group $ResourceGroupName `
        --location $location `
        --sku Standard_LRS
}

Execute o script do PowerShell:

.\myScript.ps1 -ResourceGroupName "myResourceGroupName"

Escolhendo o modo de execução certo

Caso de uso	Interativo	Com script
Aprendizagem	Melhor	Não recomendado
Tarefas únicas	Melhor	Não recomendado
Troubleshooting	Melhor	Às vezes
Tarefas repetitivas	Não recomendado	Melhor
Operações em várias etapas	Às vezes	Melhor
Pipelines de CI/CD	Não recomendado	Melhor
Infraestrutura como código	Não recomendado	Melhor

Agora que você entende a arquitetura da CLI do Azure e a estrutura de comandos, vamos escolher o ambiente certo e instalar a CLI do Azure.

Comentários

Esta página foi útil?