Criar um recurso do Azure interativamente com a CLI do Azure

  • 5 minutos

No modo interativo, a CLI do Azure permite que você insira e execute comandos imediatamente.

No exemplo do Customer Relationship Management (CRM), o objetivo é criar três ambientes de teste, cada um contendo máquinas virtuais (VMs). Use grupos de recursos para garantir que as VMs sejam organizadas em ambientes separados:

  • Teste de unidades
  • Testes de integração
  • Testes de aceitação

Como você só precisa criar os grupos de recursos uma vez, usar a CLI do Azure interativamente para essa tarefa é uma escolha razoável.

Exemplo: Como criar um grupo de recursos com a CLI do Azure

Vamos executar uma tarefa comum: criar um grupo de recursos. Os grupos de recursos ajudam você a gerenciar recursos relacionados coletivamente, e a criação de um novo grupo de recursos geralmente é uma das primeiras tarefas que você executa ao iniciar uma nova solução do Azure.

Aqui estão os três passos que você precisa seguir:

  1. Conecte-se ao Azure usando o az login.

  2. Trabalhar com assinaturas do Azure usando o az account.

  3. Trabalhar com grupos de recursos usando az groupo .

Ligar ao Azure

Ao usar uma instalação local da CLI do Azure, você deve autenticar antes de executar qualquer comando da CLI do Azure. O az login comando solicita suas credenciais do Azure e, em seguida, se conecta à sua assinatura do Azure.

Para se conectar interativamente, não é necessário especificar parâmetros:

az login

Este comando abre um prompt para suas credenciais do Azure e estabelece uma conexão com sua assinatura do Azure.

Aqui estão algumas dicas úteis ao autenticar no Azure com a CLI do Azure:

  • Se estiver executando a CLI do Azure no Azure Cloud Shell ...

    • Você é autenticado automaticamente.
    • Poderá ter de alterar a sua subscrição predefinida.

  • Ao executar a CLI do Azure por meio de uma instalação local ...

    • Você será solicitado a fornecer suas credenciais do Azure.
    • Há um seletor de assinatura no momento do login.

Trabalhar com subscrições

Se você for novo no Azure, terá apenas uma única assinatura. No entanto, se estiver a utilizar o Azure há algum tempo, poderá ter várias subscrições. A CLI do Azure permite que você configure em qual assinatura seus comandos serão executados.

Só pode estar ativo numa subscrição de cada vez. Use o az account show comando reference para determinar qual assinatura está ativa no momento. Se não for o correto, você pode alternar assinaturas usando o az account set comando reference.

  1. Obtenha uma lista de todas as suas subscrições que devolvem os resultados numa tabela:

    az account list --output table

  2. Obtenha apenas a assinatura ativa atual:

    az account show

  3. Altere a sua subscrição ativa:

    az account set --subscription "00000000-0000-0000-0000-000000000000"

Trabalhar com grupos de recursos

Ao criar recursos no Azure, você os coloca em um grupo de recursos para fins de gerenciamento.

Para criar um grupo de recursos, use o az group create comando reference. Você deve especificar um nome e um local, e o nome deve ser exclusivo em sua assinatura. O local determina onde os metadados do seu grupo de recursos são armazenados, o que pode ser importante por motivos de conformidade. Use o comando para determinar os az account list-locations locais disponíveis.

Nota

Se você estiver trabalhando em uma área restrita do Azure, ela criará o grupo de recursos para você. Se preferir trabalhar na sua própria subscrição, utilize os seguintes comandos.

A sintaxe para criar um grupo de recursos é:

az group create --name MyResourceGroup --location eastus

Para recuperar uma lista de todos os grupos de recursos na assinatura ativa, use o az group list comando.

az group list

Para uma exibição mais concisa, você pode retornar a lista em uma tabela:

az group list --output table

Ao desenvolver e testar um script da CLI do Azure, é melhor criar um grupo de recursos que contenha uma ID aleatória no nome. Adicionar uma ID aleatória ao nome do seu grupo de recursos permite que você teste novamente seu código sem ter que esperar que um grupo de recursos anterior com o mesmo nome seja removido do Azure.

#!/bin/bash
let "randomIdentifier=$RANDOM*$RANDOM"
location="eastus"
resourceGroup="msdocs-rg-$randomIdentifier"
az group create --name $resourceGroup --location $location --output json

Exemplo: Criar uma máquina virtual do Azure

Criar máquinas virtuais (VMs) é uma tarefa comum que você pode executar com a CLI do Azure.

O az vm create comando é usado para criar uma VM. Este comando tem vários parâmetros para lidar com as extensas definições de configuração para uma VM. A maioria dos parâmetros tem valores padrão razoáveis, portanto, você normalmente precisa especificar apenas cinco itens principais:

  • resource-group: o grupo de recursos onde a nova VM é colocada.
  • name: O nome da VM no Azure.
  • local: a região geográfica onde a VM é provisionada.
  • image: A imagem do sistema operacional a ser usada para a VM, normalmente uma distribuição Linux ou Windows Server.
  • admin-username: nome de usuário do administrador da VM. Você será solicitado a inserir uma senha na linha de comando.

Aqui está um exemplo de script Bash:

#!/bin/bash

# Create variables
rgName="myResourceGroupName"
vmName="myVMname"
vmImage="Win2022AzureEditionCore"
vmAdminUserName="myAzureUserName"

# Create the VM
az vm create \
    --resource-group $rgName \
    --name $vmName \
    --image $vmImage \
    --public-ip-sku Standard \
    --admin-username $vmAdminUserName

Exemplo: Obter informações para uma VM

Você pode listar as VMs em sua assinatura usando o az vm list comando. Este comando também suporta a recuperação de uma VM específica especificando o --name parâmetro.

Veja como armazenar a ID de uma VM em uma variável:

#!/bin/bash
rgName="myResourceGroupName"
vmID=$(az vm list --resource-group $rgName \
    --query "[?name=='myVMname'].id" --output tsv)
echo $vmID

Usando o az vm update comando, altere o tamanho da sua VM:

#!/bin/bash
rgName="myResourceGroupName"
vmName="msdocs-vm-01"
newVMsize="Standard_DS3_v2"

# Get the VM ID
vmID=$(az vm list --resource-group $rgName \
    --query "[?name=='$vmName'].id" --output tsv)

# Update the VM size
az vm update --ids $vmID --size $newVMsize

# Show the new properties of the VM
az vm show --resource-group $rgName --name $vmName

Este exercício demonstrou um padrão típico de uma sessão interativa da CLI do Azure. Primeiro, utilizou um comando padrão para criar um novo grupo de recursos. Em seguida, você usou um conjunto de comandos para implantar um recurso (neste exemplo, uma VM) nesse grupo de recursos. Você pode facilmente combinar esse conjunto de comandos em um shell script e executá-lo sempre que precisar criar o mesmo recurso.