Aracılığıyla paylaş

Azure CLI kullanarak uygun ölçekte kaynak oluşturma

  • Makale

Azure kaynak yöneticisi olarak, yeni ortamları yapılandırırken sık sık birden çok Azure kaynağı oluşturmanız gerekir. Ayrıca, Azure kaynakları bir betikten otomatik olarak oluşturulduğunda en iyi şekilde çalışan bir Azure kaynak onay işleminiz de olabilir.

Bu makalede şunları öğreneceksiniz:

  • Sınırlandırılmış bir CSV dosyasından alınan parametrelerden birden çok Azure kaynağı oluşturun.
  • EĞER kullan.. BAĞıMLı Azure kaynakları oluşturmak için THEN deyimleri.
  • Yerel TXT dosyasına günlük betiği ilerleme durumu.

Bu örnek betik Hem Bash hem de PowerShell ortamlarında ve PowerShell 7'de Azure Cloud Shell'de test edilmiştir. Azure-samples/azure-cli-samples içinde CSV ve tam betiği bulun.

Ortamınızı hazırlama

Ortamınızı örnek betiği çalıştıracak şekilde hazırlamak için şu adımları izleyin:

  • Bash veya PowerShell ortamını Azure Cloud Shell'de açın. Daha fazla bilgi için bkz . Azure Cloud Shell'de Bash için hızlı başlangıç.

  • Aşağıdaki CSV dosyasını indirip yerel bir dizine kaydedin. Üçüncü satırdaki yerine gerçek bir kaynak grubu adı yazın myExistingResourceGroupName .

    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]

    Not

    Düzgün bir Unix metin dosyası olmak ve Bash tarafından okunabilmesi için CSV dosyasının son veri satırının sonunda yeni bir satır karakteri olması gerekir. Bu, dosyanın sonunda boş bir satıra neden olur. Bu metin yalnızca boş bir satırın var olduğunu göstermek için sağlandığından, boş satırınızın bunu söylemesi [empty line] gerekmez. PowerShell ortamlarında bu yeni satır karakteri gereksinimi yoktur.

  • Değiştirilen CSV dosyanızı Azure Cloud Shell blog depolama hesabınıza yükleyin. Bunu yapmanın en kolay yolu, Azure Cloud Shell ana menüsündeki Dosyaları yönet açılan listesini kullanmaktır. Cloud Shell depolama hakkında daha fazla bilgi için bkz . Azure Cloud Shell'de dosyaları kalıcı hale geçirme.

Betiklere genel bakış

Bu makale, her adımın açıklanabilmesi için tek bir büyük betiği dört bölüme böler.

  • Değişken kurulumu
  • Veri doğrulaması
  • Döngü doğrulama
  • Azure kaynak oluşturma

Ayrıca iki betik de sağlanır: biri Bash için, ikincisi PowerShell için. Her iki betik de aynı Azure CLI komutlarını kullanır. Farklı olan ortam veya terminal profilidir. Örneğin, Bash ve if...then...fikullanırdo...done. PowerShell ortamında eşdeğerini foreach ve if (something is true)...{do this}kullanırsınız. Azure Cloud Shell'de, Azure Cloud Shell ana menüsündeki PowerShell'e Geç veya Bash'e Geç düğmesini kullanarak ortamlar arasında geçiş yapabilirsiniz.

İsterseniz doğrudan Azure-samples/azure-cli-samples makalesinde bu makale tarafından kullanılan CSV ve betik dosyalarına gidin.

Değişkenleri ayarla

Betik için gereken değişkenleri oluşturarak başlayın. Aşağıdaki üç değişken ortamınız için gerçek değerlere ihtiyaç duyar:

  • subscriptionID: Bu, Azure abonelik kimliğinizdir.
  • csvFileLocation: Bu, CSV giriş dosyanızın konumu ve dosya adıdır.
  • logFileLocation: Bu, betiğin günlük dosyası oluşturmak için kullanacağı konum ve dosya adıdır. Bu dosyayı oluşturmanız veya karşıya yüklemeniz gerekmez.

Önek msdocs- içeren değişkenler, seçtiğiniz ön ekle değiştirilebilir. Tüm boş ("") değişkenler CSV giriş dosyasındaki değerleri kullanır. Bu boş değişkenler, betiğin ihtiyaç duyduğu yer tutuculardır.

# 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

CSV dosya değerlerini doğrulama

Oluşturma betiğini test etmeye başlamadan önce CSV dosyanızın doğru biçimlendirildiğinden ve değişkenlere doğru değerler atandığından emin olun. Bu betik bir EĞER kullanır.. BIR kerede bir senaryoya/CSV satırına bakabilmeniz için THEN deyimi.

# 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)

Bu makalede sağlanan CSV kullanılarak doğrulama çıktısı şu şekildedir: (Rastgele 00000001 kimlik her test için farklı olacaktır.)

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

Betik mantığını doğrulama

Betik oluşturma becerilerinize güveniyorsanız bu adımı atlayabilirsiniz. Ancak, bu betik büyük ölçekte Azure kaynakları oluşturmak üzere tasarlandığından, veya write-host deyimleriyle echo betikte döngü yapmak size zaman kazandırabilir ve beklenmeyen faturalandırılabilir Azure kaynakları elde edebilirsiniz.

Bash kullanarak CSV dosyasında yineleme yapmanın çeşitli yolları vardır. Bu örnekte ile while loopkullanılırIFS.

# 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

Bu makalede sağlanan CSV kullanılarak doğrulama çıktısı şu şekildedir: (Rastgele 00000001, 2, 3 kimlikler her test için farklı olacaktır, ancak her resourceNo birinin altındaki her kaynak aynı rastgele kimliği paylaşmalıdır.)

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>

Azure kaynakları oluşturma

Artık değişken bloğunuzu oluşturdunuz, CSV değerlerinizi doğruladiniz ve veya write-hostile echo bir test çalıştırması tamamladınız. CSV giriş dosyanızda tanımlanan Azure kaynaklarını oluşturmak için betiğin dördüncü ve son bölümünü yürütebilirsiniz.

# 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

Konsol çıkışınızda CSV dosyanızdaki son satır eksik mi? Bunun nedeni, son satırdan sonraki eksik satır devamlılığı karakteri olabilir. Sorunu çözmek için CSV dosyanızın sonuna boş bir satır ekleyin.

Günlük dosyası okunmadan önce konsol çıkışı:

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

Günlük dosyası içeriğiniz şuna benzer görünmelidir:

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
  }

Sorun giderme

Bash'te 1. adımdan sonra "Azure kaynakları oluşturma" adımı durdurulur

Ubuntu 22.04.3 LTS ve Debian sürüm 12'de (kitap kurdu) Validate betiği mantığı üç kaynak için de beklenen sonuç döndüren şekilde çalışır. Ancak Azure kaynakları oluşturma, ilk kaynağın ardından durur. Bu sorunun olası bir nedeni, 1. adımda sanal ağ oluşturma işleminin birkaç saniye sürmesidir. Hem Ubuntu hem de Debian, sanal ağın tamamlanmasını beklemeden ikinci kaynağa devam eder. Bekleme sırasında bu konuda daha fazla bilgi edinebilirsiniz. While döngüsündeki işlemlerin bitmesini beklemez veya Bash betiğinde herhangi bir işlemin bitmesi betiği beklenirken.

Bash betiği IF deyimini yoksayar

Bash büyük/küçük harfe duyarlıdır. sözcüğü true eşit TRUEdeğildir. -gtAyrıca greater than , değil >ve equals , ==değil =. CSV sütun değerlerinizde yazım hatası veya başında/sonunda boşluk olmadığından emin olun.

Değişken değerleri her döngüde değişmiyor

Bunun nedeni genellikle CSV dosyasındaki fazladan boşluklar olabilir. CSV dosyasındaki bir satır şuna benzer: column1,column2,column3 veya column1,,column3gibi görünür, ancak alışkanlık gereği, gibi column1, column2, column3her virgülden sonra boşluk içeren bir test dosyası oluşturmak kolaydır. CSV'nizde baştaki veya sondaki bir alanınız olduğunda, sütun değeri aslında <space>columnValue'dir. Betik mantığı if [ "$columnName" = "columnValue" ] "false" döndürür. Sorunu çözmek için CSV satırlarınızdaki tüm baştaki ve sondaki boşlukları kaldırın.

Geçersiz CIDR gösterimi

adresine yanlış adres ön eki az network vnet creategeçirdiğinizde InvalidCIDRNotation hatası alıyorsunuz. Bu, görsel olarak bir deyimde döndürülürken adres ön eki doğru göründüğünde echo zor olabilir. CSV'den okunan gerçek değerin sorunlarını gidermek için şu betiği deneyin:

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)

Sonuçlarınız beklendiği abc10.0.0.0/24xyzgibi xzy10.0.0.0 görünüyorsa ve görünmüyorsa, CSV dosyanızda gizli bir karakter veya fazladan virgül gizlenmiş olabilir. Aynı ön ek değerine sahip bir test sütunu ekleyin, CSV sütunlarınızı yeniden düzenleyin ve BASIT bir Not Defteri düzenleyicisinde/dışında CSV içeriğinizi kopyalayın/yapıştırın. Bu makaleyi yazarken, CSV sütunlarının yeniden düzenlenmesi sonunda hatayı düzelttik.

Bağımsız değişkenler bekleniyor veya gerekli

Gerekli bir parametreyi belirtmediğinizde veya Azure CLI'nın başvuru komutunu yanlış ayrıştırmasına neden olan bir yazım hatası olduğunda bu hatayı alırsınız. Bir betikle çalışırken, aşağıdakilerden biri daha doğru olduğunda da bu hatayı alırsınız:

  • Eksik veya yanlış bir satır devamlılığı karakteri var.
  • Satır devamlılığı karakterinin sağ tarafında sondaki boşluklar vardır.
  • Değişken adınız tire (-) gibi özel bir karakter içeriyor.

InvalidTemplateDeployment

Bu kaynağı sunmayan bir konumda Azure kaynağı oluşturmaya çalıştığınızda aşağıdakine benzer bir hata alırsınız: "Aşağıdaki SKU'lar Kapasite Kısıtlamaları için başarısız oldu: Standard_DS1_v2' şu anda 'westus' konumunda kullanılamıyor."

İşte tam hata örneği:

{"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."}]}}

Hatayı düzeltmek için konumu değiştirin veya istediğiniz konum için sunulan farklı bir parametre değeri seçin.

Ayrıca bkz.