Bagikan melalui

Mulai cepat: Membuat penyimpanan Azure App Configuration menggunakan Bicep

  • Artikel

Mulai cepat ini menjelaskan cara Anda dapat menggunakan Bicep untuk:

  • Menyebarkan penyimpanan App Configuration.
  • Membuuat nilai kunci di penyimpanan App Configuration.
  • Membaca nilai kunci di penyimpanan App Configuration.

Bicep adalah bahasa pemrogram khusus domain (DSL) yang menggunakan sintaks deklaratif untuk menyebarkan sumber daya Azure. Bicep menyediakan sintaks ringkas, keamanan jenis yang andal, dan dukungan untuk penggunaan kembali kode. Bicep menawarkan pengalaman penulisan terbaik untuk solusi infrastructure-as-code di Azure.

Prasyarat

Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.

Authorization

Mengelola sumber daya Azure App Configuration dengan file Bicep memerlukan peran Azure Resource Manager, seperti kontributor atau pemilik. Mengakses data Azure App Configuration (nilai kunci, rekam jepret) memerlukan peran Azure Resource Manager dan peran bidang data Azure App Configuration tambahan saat mode autentikasi ARM penyimpanan konfigurasi diatur ke mode autentikasi ARM pass-through.

Penting

Mengonfigurasi mode autentikasi ARM memerlukan versi API sarana kontrol App Configuration atau yang lebih 2023-08-01-preview baru.

Tinjau file Bicep

File Bicep yang digunakan dalam mulai cepat berasal dari Templat Mulai Cepat Azure.

Catatan

File Bicep menggunakan mesin dasar yang sama dengan templat ARM. Semua tips, catatan, dan informasi penting yang ditemukan dalam mulai cepat templat ARM berlaku di sini. Disarankan untuk mereferensikan informasi ini saat bekerja menggunakan file Bicep.

@description('Specifies the name of the App Configuration store.')
param configStoreName string = 'appconfig${uniqueString(resourceGroup().id)}'

@description('Specifies the Azure location where the app configuration store should be created.')
param location string = resourceGroup().location

@description('Specifies the names of the key-value resources. The name is a combination of key and label with $ as delimiter. The label is optional.')
param keyValueNames array = [
  'myKey'
  'myKey$myLabel'
]

@description('Specifies the values of the key-value resources. It\'s optional')
param keyValueValues array = [
  'Key-value without label'
  'Key-value with label'
]

@description('Specifies the content type of the key-value resources. For feature flag, the value should be application/vnd.microsoft.appconfig.ff+json;charset=utf-8. For Key Value reference, the value should be application/vnd.microsoft.appconfig.keyvaultref+json;charset=utf-8. Otherwise, it\'s optional.')
param contentType string = 'the-content-type'

@description('Adds tags for the key-value resources. It\'s optional')
param tags object = {
  tag1: 'tag-value-1'
  tag2: 'tag-value-2'
}

resource configStore 'Microsoft.AppConfiguration/configurationStores@2024-05-01' = {
  name: configStoreName
  location: location
  sku: {
    name: 'standard'
  }
}

resource configStoreKeyValue 'Microsoft.AppConfiguration/configurationStores/keyValues@2024-05-01' = [for (item, i) in keyValueNames: {
  parent: configStore
  name: item
  properties: {
    value: keyValueValues[i]
    contentType: contentType
    tags: tags
  }
}]

output reference_key_value_value string = configStoreKeyValue[0].properties.value
output reference_key_value_object object = {
  name: configStoreKeyValue[1].name
  properties: configStoreKeyValue[1].properties
}

Dua sumber daya Azure ditentukan dalam file Bicep:

Dengan file Bicep ini, kami membuat satu kunci dengan dua nilai berbeda, salah satunya memiliki label unik.

Menerapkan file Bicep

  1. Simpan file Bicep sebagai main.bicep ke penyimpanan lokal komputer Anda.

  2. Sebarkan file Bicep menggunakan Azure CLI atau Azure PowerShell.

    az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters configStoreName=<store-name>

    Catatan

    Ganti <nama penyimpanan> dengan nama penyimpanan App Configuration.

    Setelah penyebaran selesai, Anda akan melihat pesan yang menunjukkan penyebaran berhasil.

Meninjau sumber daya yang disebarkan

Gunakan Azure CLI atau Azure PowerShell untuk membuat daftar sumber daya yang disebarkan di grup sumber daya.

az resource list --resource-group exampleRG

Anda juga dapat menggunakan portal Azure untuk mencantumkan sumber daya:

  1. Masuk ke portal Azure.
  2. Dalam kotak pencarian, masukkan App Configuration, lalu pilih App Configuration dari daftar.
  3. Pilih sumber daya terbaru App Configuration yang baru dibuat.
  4. Di bawah Operasi, pilih Penjelajah konfigurasi.
  5. Verifikasi bahwa ada dua nilai kunci.

Membersihkan sumber daya

Saat tidak lagi diperlukan, gunakan Azure CLI atau Azure PowerShell untuk menghapus grup sumber daya dan sumber dayanya.

az group delete --name exampleRG

Anda dapat menggunakan portal Azure untuk menghapus grup sumber daya:

  1. Arahkan ke grup sumber daya Anda.
  2. Pilih Hapus grup sumber daya.
  3. Tab akan muncul. Masukkan nama grup sumber daya, lalu pilih Hapus.

Langkah berikutnya

Untuk mempelajari tentang menambahkan tanda fitur dan referensi Key Vault ke penyimpanan App Configuration, lihat contoh templat ARM.