Partilhar via

Como criar recursos em escala usando a CLI do Azure

Como administrador de recursos de nuvem do Azure, você frequentemente precisa criar vários recursos do Azure ao configurar novos ambientes. Você também pode ter um processo de aprovação de recursos do Azure que funciona melhor quando os recursos do Azure são criados automaticamente a partir de um script.

Neste artigo, você aprenderá os seguintes itens:

  • Crie vários recursos do Azure a partir de parâmetros recebidos de um arquivo CSV delimitado.
  • Utilize as instruções IF..THEN para criar recursos dependentes do Azure.
  • Registre o progresso do script em um arquivo TXT local.

Este script de exemplo foi testado no Azure Cloud Shell usando ambientes Bash e PowerShell e PowerShell 7. Encontre o CSV e o script completo em Azure-samples/azure-cli-samples.

Prepare seu ambiente

Siga estas etapas para preparar seu ambiente para executar o script de exemplo:

  • Abra o ambiente Bash ou PowerShell no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no Azure Cloud Shell.

  • Transfira e guarde o seguinte ficheiro CSV num diretório local. Substitua myExistingResourceGroupName na linha três por um nome real do grupo de recursos.

    resourceNo,location,createRG,exstingRgName,createVnet,vnetAddressPrefix,subnetAddressPrefixes,vmImage,publicIpSku,Adminuser
1,eastus,TRUE,,TRUE,10.0.0.0/16,10.0.0.0/24,Ubuntu2204,standard,
2,eastus2,TRUE,,FALSE,,,Debian11,standard,alex-smith
3,southcentralus,FALSE,myExistingResourceGroupName,FALSE,,,Ubuntu2204,standard,jan-smith
[empty line for Bash]

    Observação

    Para ser um arquivo de texto Unix adequado e ser lido pelo Bash, o arquivo CSV precisa de um caractere de nova linha no final da última linha de dados. Isso resulta em uma linha em branco no final do arquivo. Sua linha em branco não precisa dizer [empty line], pois este texto é fornecido apenas para mostrar que existe uma linha vazia. Os ambientes do PowerShell não necessitam deste requisito de caractere de nova linha.

  • Carregue seu arquivo CSV modificado para sua conta de armazenamento de blog do Azure Cloud Shell. A maneira mais fácil de fazer isso é usar a lista suspensa Gerenciar arquivos no menu principal do Azure Cloud Shell. Para obter mais informações sobre o armazenamento do Cloud Shell, consulte Persistir ficheiros no Azure Cloud Shell.

Visão geral do script

Este artigo divide um único script grande em quatro seções, permitindo que cada etapa seja explicada.

  • Configuração variável
  • Validação de dados
  • Validação de ciclo
  • Criação de recursos do Azure

Há também dois scripts fornecidos: um para Bash e o segundo para PowerShell. Ambos os scripts usam os mesmos comandos da CLI do Azure. É o ambiente ou o perfil do terminal que é diferente. Por exemplo, o Bash usa do...done e if...then...fi. Num ambiente PowerShell, utiliza-se o equivalente foreach e if (something is true)...{do this}. No Azure Cloud Shell, você pode alternar entre ambientes usando o botão Alternar para PowerShell ou Alternar para Bash no menu principal do Azure Cloud Shell.

Se preferir, vá diretamente para os arquivos CSV e de script usados por este artigo em Azure-samples/azure-cli-samples.

Definir variáveis

Comece criando as variáveis necessárias para o script. As três variáveis a seguir precisam de valores reais para seu ambiente:

  • subscriptionID: Esta é a sua ID de subscrição do Azure.
  • csvFileLocation: Este é o local e o nome do arquivo de entrada CSV.
  • logFileLocation: Este é o local e o nome do arquivo que o script usa para criar um arquivo de log. Não é necessário criar ou carregar este ficheiro.

As variáveis com um msdocs- prefixo podem ser substituídas pelo prefixo de sua escolha. Todas as variáveis vazias ("") usam valores do arquivo de entrada CSV. Essas variáveis vazias servem como espaços reservados exigidos pelo script.

# Variable block

# Replace these three variable values with actual values
subscriptionID=00000000-0000-0000-0000-00000000
csvFileLocation="myFilePath\myFileName.csv"
logFileLocation="myFilePath\myLogName.txt"

# Variable values that contain a prefix can be replaced with the prefix of your choice.
#   These prefixes have a random ID appended to them in the script.
# Variable values without a prefix will be overwritten by the contents of your CSV file.
location=""
createRG=""
newRgName="msdocs-rg-"
existingRgName=""

createVnet=""
vnetName="msdocs-vnet-"
subnetName="msdocs-subnet-"
vnetAddressPrefix=""
subnetAddressPrefixes=""

vmName="msdocs-vm-"
vmImage=""
publicIpSku=""
adminUser=""
adminPassword="msdocs-PW-@"

# Set your Azure subscription 
az account set --subscription $subscriptionID

Validar valores de arquivo CSV

Antes de começar a testar o script, verifique se o arquivo CSV está formatado corretamente e se as variáveis receberam os valores corretos. Esse script usa uma IF..THEN instrução para que você possa examinar um cenário/linha CSV de cada vez.

# Verify CSV columns are being read correctly

# Take a look at the CSV contents
cat $csvFileLocation

# Validate select CSV row values
while IFS=, read -r resourceNo location createRG existingRgName createVnet vnetAddressPrefix subnetAddressPrefixes vmImage publicIpSku adminUser
do
  # Generate a random ID
  let "randomIdentifier=$RANDOM*$RANDOM"

  # Return the values for the first data row
  # Change the $resourceNo to check different scenarios in your CSV
  if [ "$resourceNo" = "1" ]; then
    echo "resourceNo = $resourceNo"
    echo "location = $location"
    echo "randomIdentifier = $randomIdentifier"
    echo ""
    
    echo "RESOURCE GROUP INFORMATION:"
    echo "createRG = $createRG"
    if [ "$createRG" = "TRUE" ]; then 
      echo "newRGName = $newRgName$randomIdentifier"
    else
      echo "exsitingRgName = $existingRgName"
    fi
    echo ""

    echo "VNET INFORMATION:"
    echo "createVnet = $createVnet"
    if [ "$createVnet" = "TRUE" ]; then 
      echo "vnetName = $vnetName$randomIdentifier"
      echo "subnetName = $subnetName$randomIdentifier"
      echo "vnetAddressPrefix = $vnetAddressPrefix"
      echo "subnetAddressPrefixes = $subnetAddressPrefixes"
    fi
    echo ""

    echo "VM INFORMATION:"
    echo "vmName = $vmName$randomIdentifier"
    echo "vmImage = $vmImage"
    echo "vmSku = $publicIpSku"
    if [ `expr length "$adminUser"` == "1" ]; then
      echo "SSH keys will be generated."
    else
      echo "vmAdminUser = $adminUser"
      echo "vmAdminPassword = $adminPassword$randomIdentifier"        
    fi
  fi  
# skip the header line
done < <(tail -n +2 $csvFileLocation)

Usando o CSV fornecido neste artigo, a saída de validação é a seguinte: (O 00000001 ID aleatório é diferente para cada teste.)

resourceNo = 1
location = eastus

RESOURCE GROUP INFORMATION:
createRG = TRUE
newRGName = msdocs-rg-00000001

VNET INFORMATION:
createVnet = TRUE
vnetName = msdocs-vnet-00000001
subnetName = msdocs-subnet-00000001
vnetAddressPrefix = 10.0.0.0/16
subnetAddressPrefix = 10.0.0.0/24

VM INFORMATION:
vmName = msdocs-vm-00000001
vmImage = Ubuntu2204
vmSku = standard
SSH keys will be created

Validar lógica de script

Se você estiver confiante em suas habilidades de script, poderá pular esta etapa. No entanto, como este script foi projetado para criar recursos do Azure em escala, repetir o script com instruções echo ou write-host pode economizar tempo e os recursos faturáveis inesperados do Azure.

Existem várias maneiras de iterar através de um ficheiro CSV usando o shell Bash. Este exemplo usa IFS com um while loop.

# Validate script logic

# Create the log file
echo "SCRIPT LOGIC VALIDATION.">$logFileLocation

# Loop through each row in the CSV file
while IFS=, read -r resourceNo location createRG existingRgName createVnet vnetAddressPrefix subnetAddressPrefixes vmImage publicIpSku adminUser
do
  # Generate a random ID
  let "randomIdentifier=$RANDOM*$RANDOM"
    
  # Log resource number and random ID
  echo "resourceNo = $resourceNo">>$logFileLocation
  echo "randomIdentifier = $randomIdentifier">>$logFileLocation

  # Check if a new resource group should be created
  if [ "$createRG" == "TRUE" ]; then
    echo "Will create RG $newRgName$randomIdentifier.">>$logFileLocation
    existingRgName=$newRgName$randomIdentifier
  fi

  # Check if a new virtual network should be created, then create the VM
  if [ "$createVnet" == "TRUE" ]; then
    echo "Will create VNet $vnetName$randomIdentifier in RG $existingRgName.">>$logFileLocation
    echo "Will create VM $vmName$randomIdentifier in Vnet $vnetName$randomIdentifier in RG $existingRgName.">>$logFileLocation
  else
    echo "Will create VM $vmName$randomIdentifier in RG $existingRgName.">>$logFileLocation
  fi
# Skip the header line.
done < <(tail -n +2 $csvFileLocation)

# Clear the console and display the log file
Clear
cat $logFileLocation

Usando o CSV fornecido neste artigo, a saída de validação é a seguinte: (Os 00000001, 2, 3 IDs aleatórios são diferentes para cada teste, mas cada recurso sob cada resourceNo deve compartilhar o mesmo ID aleatório.)

resourceNo = 1
createRG = TRUE
createVnet = TRUE
Will create RG msdocs-rg-00000001
Will create VNet msdocs-vnet-00000001 in RG msdocs-rg-00000001
Will create VM msdocs-vm-00000001 within Vnet msdocs-vnet-00000001 in RG msdocs-rg-00000001

resourceNo = 2
createRG = TRUE
createVnet = FALSE
Will create RG msdocs-rg-00000002
Will create VM msdocs-vm-00000002 without Vnet in RG msdocs-rg-00000002

resourceNo = 3
createRG = FALSE
createVnet = FALSE
Will create VM msdocs-vm-00000003 without Vnet in RG <myExistingResourceGroup>

Criar recursos do Azure

Você criou seu bloco de variáveis, validou seus valores CSV e concluiu uma execução de teste com echo ou write-host. Execute a quarta e última parte do script para criar recursos do Azure conforme definido no arquivo de entrada CSV.

# Create Azure resources

# Create the log file
echo "CREATE AZURE RESOURCES.">$logFileLocation

# Loop through each CSV row
while IFS=, read -r resourceNo location createRG existingRgName createVnet vnetAddressPrefix subnetAddressPrefixes vmImage publicIpSku adminUser
do
  # Generate a random ID
  let "randomIdentifier=$RANDOM*$RANDOM"

  # Log resource number, random ID and display start time
  echo "resourceNo = $resourceNo">>$logFileLocation
  echo "randomIdentifier = $randomIdentifier">>$logFileLocation
  echo "Starting creation of resourceNo $resourceNo at $(date +"%Y-%m-%d %T")."

  # Check if a new resource group should be created
  if [ "$createRG" == "TRUE" ]; then
    echo "Creating RG $newRgName$randomIdentifier at $(date +"%Y-%m-%d %T").">>$logFileLocation
    az group create --location $location --name $newRgName$randomIdentifier >>$logFileLocation
    existingRgName=$newRgName$randomIdentifier
    echo "  RG $newRgName$randomIdentifier creation complete"
  fi

  # Check if a new virtual network should be created, then create the VM
  if [ "$createVnet" == "TRUE" ]; then
    echo "Creating VNet $vnetName$randomIdentifier in RG $existingRgName at $(date +"%Y-%m-%d %T").">>$logFileLocation
    az network vnet create \
        --name $vnetName$randomIdentifier \
        --resource-group $existingRgName \
        --address-prefix $vnetAddressPrefix \
        --subnet-name $subnetName$randomIdentifier \
        --subnet-prefixes $subnetAddressPrefixes >>$logFileLocation
    echo "  VNet $vnetName$randomIdentifier creation complete"
    
    echo "Creating VM $vmName$randomIdentifier in Vnet $vnetName$randomIdentifier in RG $existingRgName at $(date +"%Y-%m-%d %T").">>$logFileLocation
    az vm create \
        --resource-group $existingRgName \
        --name $vmName$randomIdentifier \
        --image $vmImage \
        --vnet-name $vnetName$randomIdentifier \
        --subnet $subnetName$randomIdentifier \
        --public-ip-sku $publicIpSku \
        --generate-ssh-keys >>$logFileLocation
    echo "  VM $vmName$randomIdentifier creation complete"
  else
    echo "Creating VM $vmName$randomIdentifier in RG $existingRgName at $(date +"%Y-%m-%d %T").">>$logFileLocation
    az vm create \
        --resource-group $existingRgName \
        --name $vmName$randomIdentifier \
        --image $vmImage \
        --public-ip-sku $publicIpSku \
        --admin-username $adminUser\
        --admin-password $adminPassword$randomIdentifier >>$logFileLocation
    echo "  VM $vmName$randomIdentifier creation complete"    
  fi
# skip the header line
done < <(tail -n +2 $csvFileLocation)

# Clear the console (optional) and display the log file
# clear
cat $logFileLocation

Na saída do terminal, estás a perder a última linha do ficheiro CSV? Esse problema pode ser causado por um caractere de continuação de linha ausente após a última linha. Para corrigir o problema, adicione uma linha em branco no final do arquivo CSV.

Resultado do console antes de ler o ficheiro de log:

Starting creation of resourceNo 1 at YYYY-MM-DD HH:MM:SS.
  RG msdocs-rg-00000001 creation complete
  VNet msdocs-vnet-00000001 creation complete
  VM msdocs-vm-00000001 creation complete

Starting creation of resourceNo 2 at YYYY-MM-DD HH:MM:SS.
  RG msdocs-rg-00000002 creation complete
  VM msdocs-vm-00000002 creation complete

Starting creation of resourceNo 3 at YYYY-MM-DD HH:MM:SS.
  VM msdocs-vm-00000003 creation complete

O conteúdo do ficheiro de log deve ter a seguinte aparência:

Starting creation of resourceNo 1 at YYYY-MM-DD HH:MM:SS.
  Creating RG msdocs-rg-00000001 at YYYY-MM-DD HH:MM:SS.
  {
  Resource group create output
  }
  Creating VNet msdocs-vnet-00000001 in RG msdocs-rg-000000001 at YYYY-MM-DD HH:MM:SS.
  {
  VNet create output
  }  
  Creating VM msdocs-vm-00000001 in RG msdocs-rg-00000001 at YYYY-MM-DD HH:MM:SS.
  {
  VM create output
  }

Starting creation of resourceNo 2 at YYYY-MM-DD HH:MM:SS.
  Creating RG msdocs-rg-00000002 at YYYY-MM-DD HH:MM:SS.
  {
  Resource group create output
  }
  Creating VM msdocs-vm-00000002 in RG msdocs-rg-00000002 at YYYY-MM-DD HH:MM:SS.
  {
  VM create output
  }

Starting creation of resourceNo 3 at YYYY-MM-DD HH:MM:SS.
  Creating msdocs-vm-00000003 creation complete
  {
  VM create output
  }

Solução de problemas

No Bash, a etapa "Criar recursos do Azure" pára na etapa 1.

No Ubuntu 22.04.3 LTS e Debian versão 12 (bookworm), a lógica de script Validate funciona como esperado, retornando resultados para todos os três recursos. Contudo, a criação de recursos do Azure para após o primeiro recurso ser criado. Uma possível razão para esse problema é que a criação da VNet na etapa #1 leva alguns segundos. Tanto o Ubuntu quanto o Debian prosseguem para o segundo recurso sem esperar pela conclusão da VNet. Você pode ler mais sobre isso em a função wait não aguarda que os processos no ciclo while terminem ou Aguardando que qualquer processo termine no script bash.

O script Bash ignora a instrução IF

O Bash diferencia maiúsculas de minúsculas. A palavra true não é igual TRUE. Também greater than é -gt, não >, e equals é ==, não =. Certifique-se de que não tem erros tipográficos ou espaços à esquerda/à direita nos valores das colunas CSV.

Os valores das variáveis não mudam com cada loop

Esse problema geralmente é causado por espaços extras no arquivo CSV. Uma linha em um arquivo CSV se parece com isto: column1,column2,column3 ou column1,,column3, mas por hábito é fácil criar um arquivo de teste que contém um espaço após cada vírgula como column1, column2, column3. Quando tens um espaço no início ou no fim no teu ficheiro CSV, o valor da coluna é realmente <space>columnValue. A lógica if [ "$columnName" = "columnValue" ] de script retorna "false". Para corrigir o problema, remova todos os espaços à esquerda e à direita nas linhas CSV.

Notação CIDR inválida

Você recebe um erro InvalidCIDRNotation quando você passa um prefixo de endereço incorreto para az network vnet create. Isso pode ser desafiador quando, visualmente, o prefixo de endereço parece correto quando retornado numa echo instrução. Para solucionar problemas do valor real que está sendo lido do CSV, tente este script:

while IFS=, read -r resourceNo location createRG existingRgName createVnet vnetAddressPrefix subnetAddressPrefixes vmImage publicIpSku adminUser
do
    echo "resourceNo = $resourceNo"

    if [ "$createVnet" == "TRUE" ]; then
      startTest="abc"
      endTest="xyz"
      echo $startTest$vnetAddressPrefix$endTest
    fi
done < <(tail -n +2 $setupFileLocation)

Se os resultados forem parecidos xzy10.0.0.0 e não forem os esperados abc10.0.0.0/24xyz, pode haver um caractere oculto ou vírgula extra à espreita no arquivo CSV. Adicione uma coluna de teste com o mesmo valor de prefixo, reorganize as colunas CSV e copie/cole o conteúdo CSV dentro/fora de um editor simples do Bloco de Notas. Ao escrever este artigo, a reorganização das colunas CSV finalmente corrigiu o erro.

Os argumentos são esperados ou necessários

Você recebe esse erro quando não fornece um parâmetro necessário ou há um erro tipográfico que faz com que a CLI do Azure analise incorretamente o comando de referência. Ao trabalhar com um script, você também recebe esse erro quando um ou mais dos seguintes itens forem verdadeiros:

  • Há um caractere de continuação de linha ausente ou incorreto.
  • Há espaços à direita no lado direito de um caractere de continuação de linha.
  • O nome da variável contém um caractere especial, como um traço (-).

ImplementaçãoDeTemplateInválida

Quando você tenta criar um recurso do Azure em um local que não oferece esse recurso, você recebe um erro como a seguinte mensagem: "Falha nas seguintes SKUs para restrições de capacidade: Standard_DS1_v2' não está disponível no momento no local 'westus'."

Aqui está o exemplo de erro completo:

{"error":{"code":"InvalidTemplateDeployment","message":"The template deployment 'vm_deploy_<32 character ID>'
is not valid according to the validation procedure. The tracking id is '<36 character ID>'.
See inner errors for details.","details":[{"code":"SkuNotAvailable","message":"The requested VM size for resource
'Following SKUs have failed for Capacity Restrictions: Standard_DS1_v2' is currently not available
in location '<your specified location>'. Please try another size or deploy to a different location
or different zone. See https://aka.ms/azureskunotavailable for details."}]}}

Para corrigir o erro, altere o local ou selecione um valor de parâmetro diferente que é oferecido para o local desejado.

Ver também