Funkcja pliku parameters dla Bicep
Bicep udostępnia funkcję o nazwie readEnvironmentVariable() , która umożliwia pobieranie wartości ze zmiennych środowiskowych. Zapewnia również elastyczność ustawiania wartości domyślnej, jeśli zmienna środowiskowa nie istnieje. Tej funkcji można używać tylko w plikach .bicepparam . Aby uzyskać więcej informacji, zobacz plik parametrów Bicep.
getSecret
getSecret(subscriptionId, resourceGroupName, keyVaultName, secretName, secretVersion)
Zwraca wpis tajny z usługi Azure Key Vault. Ta funkcja służy do przekazywania wpisu tajnego do bezpiecznego parametru ciągu pliku Bicep.
Uwaga
Możesz również użyć funkcji keyVaultName.getSecret(secretName) z pliku .bicep .
using './main.bicep'
param secureUserName = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretUserName')
param securePassword = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretPassword')
Jeśli używasz tej funkcji z interpolacją ciągów, wystąpi błąd.
Można użyć kwalifikatora przestrzeni nazw (az), ale jest to opcjonalne, ponieważ funkcja jest dostępna z domyślnej przestrzeni nazw platformy Azure.
Parametry
| Parametr | Wymagania | Type | Opis |
|---|---|---|---|
| subscriptionId | Tak | string | Identyfikator subskrypcji, która ma zasób magazynu kluczy. |
| resourceGroupName | Tak | string | Nazwa grupy zasobów, która ma zasób magazynu kluczy. |
| keyVaultName | Tak | string | Nazwa magazynu kluczy. |
| secretName | Tak | string | Nazwa wpisu tajnego przechowywanego w magazynie kluczy. |
| secretVersion | Nie. | string | Wersja wpisu tajnego przechowywanego w magazynie kluczy. |
Wartość zwracana
Wartość wpisu tajnego.
Przykład
Poniższy .bicepparam plik zawiera parametr, który ma najnowszą securePassword wartość wpisu tajnego <secretName> .
using './main.bicep'
param securePassword = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretPassword')
.bicepparam Poniższy plik zawiera securePassword parametr, który ma wartość wpisu tajnego <secretName>, ale jest przypięty do określonej< wartości secretValue.>
using './main.bicep'
param securePassword = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretPassword', 'exampleSecretVersion')
readEnvironmentVariable
readEnvironmentVariable(variableName, [defaultValue])
Zwraca wartość zmiennej środowiskowej lub ustaw wartość domyślną, jeśli zmienna środowiskowa nie istnieje. Ładowanie zmiennych odbywa się podczas kompilacji, a nie w czasie wykonywania.
Przestrzeń nazw: sys.
Parametry
| Parametr | Wymagania | Type | Opis |
|---|---|---|---|
| Variablename | Tak | string | Nazwa zmiennej. |
| Defaultvalue | Nie. | string | Wartość ciągu domyślnego, która ma być używana, jeśli zmienna środowiskowa nie istnieje. |
Wartość zwracana
Wartość ciągu zmiennej środowiskowej lub wartość domyślna.
Przykłady
W poniższych przykładach pokazano, jak pobrać wartości zmiennych środowiskowych.
use './main.bicep'
param adminPassword = readEnvironmentVariable('admin_password')
param boolfromEnvironmentVariables = bool(readEnvironmentVariable('boolVariableName','false'))
Następne kroki
Aby uzyskać więcej informacji na temat pliku parametrów Bicep, zobacz Plik parametrów.