Fungsi file parameter untuk Bicep
Bicep menyediakan fungsi yang disebut readEnvironmentVariable() yang memungkinkan Anda mengambil nilai dari variabel lingkungan. Ini juga menawarkan fleksibilitas untuk menetapkan nilai default jika variabel lingkungan tidak ada. Fungsi ini hanya dapat digunakan dalam .bicepparam file. Untuk informasi selengkapnya, lihat File parameter Bicep.
getSecret
getSecret(subscriptionId, resourceGroupName, keyVaultName, secretName, secretVersion)
Mengembalikan rahasia dari Azure Key Vault. Gunakan fungsi ini untuk meneruskan rahasia ke parameter string aman dari file Bicep.
Catatan
Anda juga dapat menggunakan fungsi keyVaultName.getSecret(secretName) dari dalam .bicep file.
using './main.bicep'
param secureUserName = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretUserName')
param securePassword = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretPassword')
Anda mendapatkan kesalahan jika Anda menggunakan fungsi ini dengan interpolasi string.
Kualifikasi namespace (az) dapat digunakan, tetapi bersifat opsional, karena fungsi tersedia dari Azure Namespace default.
Parameter
| Parameter | Wajib | Tipe | Deskripsi |
|---|---|---|---|
| subscriptionId | Ya | string | ID langganan yang memiliki sumber daya brankas kunci. |
| resourceGroupName | Ya | string | Nama grup sumber daya yang memiliki sumber daya brankas kunci. |
| keyVaultName | Ya | string | Nama brankas kunci. |
| secretName | Ya | string | Nama rahasia yang disimpan di brankas kunci. |
| secretVersion | No | string | Versi rahasia yang disimpan di brankas kunci. |
Nilai hasil
Nilai untuk rahasia.
Contoh
File berikut .bicepparam memiliki securePassword parameter yang memiliki nilai terbaru rahasia< secretName.>
using './main.bicep'
param securePassword = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretPassword')
File berikut .bicepparam memiliki parameter yang memiliki nilai< rahasia secretName>, tetapi disematkan ke secretValue> tertentu<.securePassword
using './main.bicep'
param securePassword = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretPassword', 'exampleSecretVersion')
readEnvironmentVariable
readEnvironmentVariable(variableName, [defaultValue])
Mengembalikan nilai variabel lingkungan, atau mengatur nilai default jika variabel lingkungan tidak ada. Pemuatan variabel terjadi selama kompilasi, bukan pada waktu proses.
Namespace: sys.
Parameter
| Parameter | Wajib | Tipe | Deskripsi |
|---|---|---|---|
| variableName | Ya | string | Nama variabel. |
| defaultValue | No | string | Nilai string default yang akan digunakan jika variabel lingkungan tidak ada. |
Nilai hasil
Nilai string variabel lingkungan atau nilai default.
Contoh
Contoh berikut menunjukkan cara mengambil nilai variabel lingkungan.
use './main.bicep'
param adminPassword = readEnvironmentVariable('admin_password')
param boolfromEnvironmentVariables = bool(readEnvironmentVariable('boolVariableName','false'))
Langkah berikutnya
Untuk informasi selengkapnya tentang file parameter Bicep, lihat File parameter.