Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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.
- Use instruções IF..THEN para criar recursos dependentes do Azure.
- Registrar 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. Localize o CSV e o script completo em amostras do Azure/azure-cli-samples.
Prepare o seu ambiente
Siga estas etapas para preparar seu ambiente para executar o script de exemplo:
Abra o ambiente do Bash ou do PowerShell no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.
Baixe e salve o arquivo CSV a seguir em um diretório local. Substitua
myExistingResourceGroupName
na linha três por um nome de grupo de recursos real.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 só é fornecido para mostrar que existe uma linha vazia. Os ambientes do PowerShell não têm esse 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 Manter arquivos 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 de variável
- Validação de dados
- Validação de ciclo
- Criação de recursos do Azure
Também há dois scripts fornecidos: um para Bash e o segundo para o PowerShell. Ambos os scripts usam os mesmos comandos da CLI do Azure. É o ambiente ou o perfil de terminal que é diferente. Por exemplo, o Bash usa do...done
e if...then...fi
. Em um ambiente do PowerShell, você usa 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 o 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: essa é a ID da assinatura do Azure.
- csvFileLocation: esse é o local e o nome do arquivo de entrada CSV.
- logFileLocation: esse é o local e o nome do arquivo que o script usa para criar um arquivo de log. Você não precisa criar ou carregar esse arquivo.
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 recebem os valores corretos. Esse script usa uma instrução IF..THEN
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: (A 00000001
ID aleatória é 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 do script
Se você estiver confiante em suas habilidades de script, poderá ignorar esta etapa. No entanto, como esse script foi projetado para criar recursos do Azure em escala, executar um loop no script usando as instruções echo
ou write-host
pode economizar tempo e recursos faturáveis inesperados do Azure.
Há várias maneiras de iterar por meio de um arquivo 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: (As 00000001, 2, 3
IDs aleatórias são diferentes para cada teste, mas cada recurso sob cada resourceNo
compartilha a mesma ID aleatória.)
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 em seu 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 console, está faltando a última linha no seu arquivo 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.
Saída do console antes da leitura do arquivo 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 arquivo de registro deve ser semelhante à saída a seguir:
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
}
Resolução de problemas
No Bash, a etapa "Criar recursos do Azure" é interrompida após a etapa 1
No Ubuntu 22.04.3 LTS e Debian versão 12 (bookworm), a lógica Validar do script funciona conforme o esperado, retornando resultados para os três recursos. No entanto, a criação de recursos do Azure é interrompida após a criação do primeiro recurso. Um possível motivo para esse problema é que a criação da VNet na etapa nº 1 leva alguns segundos. Tanto o Ubuntu quanto o Debian avançam para o segundo recurso sem esperar pela conclusão da VNet. Você pode ler mais sobre isso em wait não aguarda que os processos no loop while sejam concluídos ou aguardando que qualquer processo seja concluído em um script bash.
O script Bash ignora a instrução IF
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 você não tenha erros tipográficos ou espaços no início ou no final em seus valores de coluna CSV.
Valores variáveis não estão sendo alterados com cada loop
Esse problema geralmente é causado por espaços extras no arquivo CSV. Uma linha em um arquivo CSV tem esta aparência: column1,column2,column3
ou column1,,column3
, por hábito, é fácil criar um arquivo de teste que contenha um espaço após cada vírgula como column1, column2, column3
. Quando você tem um espaço à esquerda ou à direita em seu CSV, o valor da coluna é na verdade <space>columnValue
. A lógica do script if [ "$columnName" = "columnValue" ]
retorna "false". Para corrigir o problema, remova todos os espaços à esquerda e à direita em suas linhas CSV.
Notação CIDR inválida
Você recebe um erro InvalidCIDRNotation ao passar 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 em uma instrução echo
. Para diagnosticar o valor que está efetivamente sendo lido do CSV, experimente 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 semelhantes xzy10.0.0.0
e não os esperados abc10.0.0.0/24xyz
, poderá haver um caractere oculto ou vírgula extra à espreita no arquivo CSV. Adicione uma coluna de teste com o mesmo valor de prefixo, reorganize suas colunas CSV e copie/cole seu conteúdo CSV dentro/fora de um editor simples do Bloco de Notas. Ao escrever este artigo, o rearranjo das colunas CSV finalmente corrigiu o erro.
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 receberá esse erro quando um ou mais dos itens a seguir forem verdadeiros:
- Há um caractere de continuação de linha ausente ou incorreto.
- Existem espaços em branco à direita de um caractere de continuação de linha.
- O nome da variável contém um caractere especial, como um traço (
-
).
InvalidTemplateDeployment
Quando você tenta criar um recurso do Azure em um local que não oferece esse recurso, recebe um erro com uma mensagem semelhante à seguinte: "Falha nas seguintes SKUs devido a restrições de capacidade: 'Standard_DS1_v2' não está disponível no local 'westus'."
Este é 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.