Crie um Recurso do Azure de forma interativa com a CLI do Azure

• 5 minutos

No modo interativo, a CLI do Azure permite inserir e executar comandos imediatamente.

No exemplo do Gerenciamento de Relacionamento com o Cliente (CRM), o objetivo é criar três ambientes de teste, cada um com suas próprias máquinas virtuais (VMs). Use grupos de recursos para manter as VMs organizadas em ambientes distintos:

• Teste de unidade
• Teste de integração
• Teste de aceitação

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

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

Vamos realizar uma tarefa comum: criar um grupo de recursos. Os grupos de recursos ajudam a gerenciar coletivamente recursos relacionados, e criar um novo grupo de recursos é geralmente uma das primeiras tarefas ao começar uma nova solução no Azure.

Estas são as três etapas que você precisa seguir:

1. Conectar-se ao Azure usando az login.

2. Trabalhar com assinaturas do Azure usando az account.

3. Trabalhar com grupos de recursos usando az group.

Conectar-se ao Azure

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

Para conectar-se de forma interativa, não é necessário especificar parâmetros:

az login

Esse comando abre uma janela para inserir suas credenciais do Azure e estabelece uma conexão com a sua assinatura do Azure.

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

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

  • Você é autenticado automaticamente.
  • Talvez seja necessário alterar a assinatura padrão.

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

  • Você será solicitado a inserir suas credenciais do Azure.
  • Há um seletor de assinaturas no momento do logon.

Trabalhar com assinaturas

Se você ainda não está familiarizado com o Azure, você só possui uma assinatura única. No entanto, se você já usa o Azure há algum tempo, já deve ter várias assinaturas. A CLI do Azure permite configurar a assinatura na qual seus comandos são executados.

Você só pode estar ativo em uma assinatura de cada vez. Use o comando de referência az account show para determinar qual assinatura está ativa no momento. Se não for a correta, você poderá alternar assinaturas usando o comando de referência az account set.

1. Obtenha uma lista de todas as suas assinaturas retornando os resultados em uma tabela:

   az account list --output table
   

2. Obtenha apenas a assinatura ativa atual:

   az account show
   

3. Altere sua assinatura ativa:

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

Trabalhar com grupos de recursos

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

Para criar um grupo de recursos, use o comando de referência az group create. Você precisa especificar um nome e uma localização, e o nome deve ser único dentro da sua assinatura. A localização determina o local em que os metadados para seu grupo de recursos são armazenados, o que pode ser relevante por questões de conformidade. Use o comando az account list-locations para determinar as localidades disponíveis.

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 comando az group list.

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 grupo de recursos permite retestar o código sem precisar 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

A criação de máquinas virtuais (VMs) é uma tarefa comum que você pode executar com a CLI do Azure.

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

• resource-group: o grupo de recursos onde a nova VM será alocada.
• nome: o nome da VM no Azure.
• local: a região geográfica onde a VM será provisionada.
• imagem: A imagem do sistema operacional a ser usada para a VM, geralmente uma distribuição do 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.

#!/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

# 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 sobre uma VM

É possível listar as VMs em sua assinatura com o comando az vm list. Esse comando também dá suporte à recuperação de uma VM específica especificando o parâmetro --name.

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

Use o comando az vm update para alterar o tamanho da 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 para uma sessão interativa da CLI do Azure. Primeiro, você usou um comando padrão para criar um novo grupo de recursos. Você usou um conjunto de comandos para implantar um recurso (nesse exemplo, uma VM) nesse grupo de recursos. Você pode combinar facilmente esse conjunto de comandos em um script de shell e executá-lo sempre que precisar criar o mesmo recurso.