O que é a CLI do Azure?

4 minutos

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

O que é a CLI do Azure?

A CLI do Azure permite que você:

Execute comandos interativamente: Digite comandos em um prompt de terminal e veja os resultados imediatos.
Automatize por meio de scripts: Combine comandos em Bash, PowerShell ou outros scripts de shell para tarefas repetitivas.
Gerenciar todos os serviços do Azure: Crie, configure, exclua e monitore os recursos do Azure usando sintaxe consistente.
Trabalhe em qualquer lugar: Instale no Linux, macOS, Windows, contêineres do 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	Instalador MSI
Docker	Bash	Imagem de contêiner pré-construída
Azure Cloud Shell	Bash, PowerShell	Embutido (não requer instalação)

Ambientes recomendados:

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

Os detalhes da instalação e os padrões de execução de comando são explicados detalhadamente 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 e extensõesprincipais. Entender a diferença ajuda você a gerenciar a instalação da CLI do Azure e a acessar os recursos mais recentes.

Referências principais

As principais referências são comandos internos permanentes 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 funcionalidades opcionais e especializadas que são executadas como comandos da CLI do Azure:

Instalação opcional: Não incluído por padrão; instale apenas quando for necessário.
Acesse novos recursos: Obtenha recursos de versão prévia e experimentais do Azure antes que eles se tornem GA (Disponibilidade Geral).
Atualizações flexíveis: Atualize as extensões independentemente da CLI principal do Azure.
Solicitação automática: A CLI do Azure solicita que você instale uma extensão no primeiro uso.

Casos de uso comuns para extensões:

Recursos de 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ê executar um comando de extensão, a CLI do Azure solicitará:

$ 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	Implementação em Produção	Nível de Suporte
GA (disponível em geral)	Permanente	Yes	Suporte completo da Microsoft
Versão prévia pública	Pode ser alterado com base nos comentários	Use com cuidado	Sujeito aos Termos de Visualização do Azure
Preterido	Será removido	Não	Migrar para substituição

Detalhes do status:

GA (disponível em geral):
- Comandos prontos para produção e estáveis.
- Alterações incompatíveis apenas em atualizações de versão principal.
- 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 comentários.
- Pode ter alterações significativas sem aviso prévio.
- Suporte limitado; relatar problemas por meio do GitHub ou de canais de comentários.
- Teste em ambientes de desenvolvimento antes do uso em produção.
Deprecado:
- Comando programado para remoção em uma versão futura.
- Normalmente substituído por um comando mais recente e melhor.
- Caminho de migração fornecido na documentação.
- Evite usar em novos scripts ou automação.

Importante: Os comandos core e extension podem ter qualquer status. Um comando principal pode estar em versão prévia e um comando de extensão pode ser GA.

Padrão de referência da CLI do Azure

A CLI do Azure usa uma estrutura de comandos hierárquica consistente que facilita a previsão e a memória 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>

Detalhamento do componente:

Componente	Description	Example
az	Comando base (sempre necessário)	`az`
Grupo de referência	Categoria ou serviço do Azure	`account`, `group`, , `storagevm`
Subgrupo	Tipo de recurso específico (opcional)	`blob`, `container`, `disk`
Command	Ação a ser executada	`create`, `list`, , `deleteshow`
Parâmetro	Opções que modificam o comportamento	`--name`, `--resource-group`, `--location`
Valor	Dados fornecidos para parâmetro	`myStorageAccount`, `eastus`

Exemplo prático: alterar a assinatura do Azure

Cenário: Alterne 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 assinatura ativa).
Parâmetro:--subscription (especifica qual assinatura).
Valor do parâmetro:"my subscription name" (seu nome de assinatura ou ID).

Mais exemplos de comando

Criar 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 (grupo que contém)

Dica de reconhecimento de padrão: Os comandos seguem padrões de linguagem natural. Se você quiser "criar uma conta de armazenamento em um grupo de recursos", você usará 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 script. Escolha a abordagem que melhor se ajusta ao fluxo de trabalho.

Execução interativa

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

Aprendendo comandos e sintaxe da CLI do Azure.
Explorando recursos do Azure e suas propriedades.
Tarefas pontuais rápidas (criando um recurso de teste, verificando o status).
Solução de problemas e depuração.

Como funciona:

Abra seu shell preferencial (Bash, PowerShell, cmd.exe, Azure Cloud Shell).
Digite o comando da CLI do Azure na linha de comando.
Pressione Enter para executar.
Exiba 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 com script combina vários comandos da CLI do Azure em um arquivo de script para automação. Essa abordagem é essencial para:

Tarefas repetitivas (criando ambientes de desenvolvimento diariamente).
Operações complexas de várias etapas (implantando aplicativos inteiros).
Pipelines de CI/CD (implantações automatizadas).
Implementações de IaC (infraestrutura como código).

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.
Tornar 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 correto

Caso de Uso	Interativo	Com script
Aprendizagem	Melhor	Não recomendado
Tarefas pontuais	Melhor	Não recomendado
Solução de problemas	Melhor	Às vezes
Tarefas repetitivas	Não recomendado	Melhor
Operações de 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?