Menggunakan variabel dan perulangan output

Selesai

Anda telah mempelajari cara menggunakan perulangan salinan untuk menyebarkan beberapa contoh sumber daya dan cara mengatur properti sumber daya dengan menggunakan perulangan. Di Bicep, perulangan juga dapat digunakan dengan variabel dan output.

Untuk perusahaan mainan boneka Anda, Anda perlu menyebarkan jaringan virtual dengan konfigurasi subnet yang sama di beberapa kawasan Azure. Anda berharap bahwa Anda harus menambahkan subnet tambahan ke jaringan virtual Anda di masa depan, sehingga Anda ingin memiliki fleksibilitas dalam templat Bicep Anda untuk memodifikasi konfigurasi subnet.

Karena Anda juga akan menyebarkan beberapa akun penyimpanan di lingkungan Azure, Anda harus menyediakan titik akhir untuk setiap akun penyimpanan sebagai output agar alur penyebaran Anda dapat menggunakan informasi ini.

Di unit ini, Anda mempelajari cara menggunakan perulangan dengan variabel dan output.

Catatan

Perintah dalam unit ini ditampilkan untuk mengilustrasikan konsep. Jangan jalankan perintah terlebih dahulu. Anda akan segera mempraktikkan apa yang Anda pelajari di sini.

Perulangan variabel

Dengan menggunakan perulangan variabel, Anda dapat membuat array, yang kemudian dapat Anda gunakan melalui file Bicep Anda. Seperti yang Anda lakukan dengan perulangan lain, Anda menggunakan kata kunci for untuk membuat perulangan variabel:

var items = [for i in range(1, 5): 'item${i}']

Contoh sebelumnya membuat array yang berisi nilai item1, item2, item3, item4, dan item5.

Anda biasanya akan menggunakan perulangan variabel untuk membuat objek yang lebih kompleks yang kemudian dapat Anda gunakan dalam deklarasi sumber daya. Berikut cara menggunakan perulangan variabel untuk membuat properti subnets:

param addressPrefix string = '10.10.0.0/16'
param subnets array = [
  {
    name: 'frontend'
    ipAddressRange: '10.10.0.0/24'
  }
  {
    name: 'backend'
    ipAddressRange: '10.10.1.0/24'
  }
]

var subnetsProperty = [for subnet in subnets: {
  name: subnet.name
  properties: {
    addressPrefix: subnet.ipAddressRange
  }
}]

resource virtualNetwork 'Microsoft.Network/virtualNetworks@2021-08-01' = {
  name: 'teddybear'
  location: resourceGroup().location
  properties:{
    addressSpace:{
      addressPrefixes:[
        addressPrefix
      ]
    }
    subnets: subnetsProperty
  }
}

Contoh ini mengilustrasikan penggunaan perulangan variabel secara efektif: mengubah parameter yang memiliki nilai sederhana dan mudah dipahami menjadi objek yang lebih kompleks yang sesuai dengan definisi sumber daya Azure yang diperlukan. Anda menggunakan perulangan variabel untuk mengaktifkan parameter untuk menentukan hanya informasi kunci yang akan berubah untuk setiap item dalam daftar. Anda kemudian dapat menggunakan ekspresi Bisep atau nilai default untuk mengatur properti lain yang diperlukan untuk sumber daya.

Perulangan output

Anda menggunakan output Bicep untuk memberikan informasi dari penyebaran Anda kembali ke pengguna atau alat yang memulai penyebaran. Perulangan output memberi Anda fleksibilitas dan kekuatan perulangan dalam output Anda.

Seperti yang Anda lakukan dengan perulangan lain, Anda menggunakan kata kunci for untuk menentukan perulangan output:

var items = [
  'item1'
  'item2'
  'item3'
  'item4'
  'item5'
]

output outputItems array = [for i in range(0, length(items)): items[i]]

Anda biasanya akan menggunakan perulangan output bersama dengan perulangan lain dalam templat Anda. Misalnya, mari kita lihat file Bicep yang menyebarkan sekumpulan akun penyimpanan ke kawasan Azure yang ditentukan oleh parameter locations:

param locations array = [
  'westeurope'
  'eastus2'
  'eastasia'
]

resource storageAccounts 'Microsoft.Storage/storageAccounts@2021-09-01' = [for location in locations: {
  name: 'toy${uniqueString(resourceGroup().id, location)}'
  location: location
  kind: 'StorageV2'
  sku: {
    name: 'Standard_LRS'
  }
}]

Anda mungkin perlu mengembalikan informasi tentang setiap akun penyimpanan yang telah Anda buat, seperti namanya dan titik akhir yang dapat digunakan untuk mengaksesnya. Dengan menggunakan perulangan output, Anda dapat mengambil informasi ini dalam file Bicep Anda.

Catatan

Saat ini, Bicep tidak mendukung sumber daya referensi langsung yang telah dibuat dalam perulangan dari dalam perulangan output. Artinya, Anda perlu menggunakan pengindeks array untuk mengakses sumber daya, seperti yang ditunjukkan pada contoh berikutnya.

output storageEndpoints array = [for i in range(0, length(locations)): {
  name: storageAccounts[i].name
  location: storageAccounts[i].location
  blobEndpoint: storageAccounts[i].properties.primaryEndpoints.blob
  fileEndpoint: storageAccounts[i].properties.primaryEndpoints.file
}]

Perhatian

Jangan gunakan output untuk mengembalikan rahasia, seperti kunci akses atau kata sandi. Output dicatat dan tidak dirancang untuk menangani data yang aman.