Bicep에 대한 매개 변수 파일 함수

Bicep은 환경 변수에서 값을 검색할 수 있는 readEnvironmentVariable()이라는 함수를 제공합니다. 또한 환경 변수가 없는 경우 기본값을 유연하게 설정할 수 있습니다. 이 함수는 .bicepparam 파일에서만 사용할 수 있습니다. 자세한 내용은 Bicep 매개 변수 파일을 참조하세요.

getSecret

getSecret(subscriptionId, resourceGroupName, keyVaultName, secretName, secretVersion)

Azure Key Vault에서 비밀을 반환합니다. 이 함수를 사용하여 Bicep 파일의 보안 문자열 매개 변수에 비밀을 전달합니다.

참고 항목

.bicep 파일 내에서 keyVaultName.getSecret(secretName) 함수를 사용할 수도 있습니다.

using './main.bicep'

param secureUserName = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretUserName')
param securePassword = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretPassword')

문자열 보간과 함께 이 함수를 사용하면 오류가 발생합니다.

네임스페이스 한정자(az)를 사용할 수 있지만 이 함수는 기본 Azure 네임스페이스에서 사용할 수 있으므로 선택 사항입니다.

매개 변수

매개 변수	필수	Type	설명
subscriptionId	예	string	키 자격 증명 모음 리소스가 있는 구독의 ID입니다.
resourceGroupName	예	string	키 자격 증명 모음 리소스가 있는 리소스 그룹의 이름입니다.
keyVaultName	예	string	키 자격 증명 모음 이름입니다.
secretName	예	string	키 자격 증명 모음에 저장된 비밀의 이름입니다.
secretVersion	아니요	string	키 자격 증명 모음에 저장된 비밀의 버전입니다.

반환 값

비밀의 값입니다.

예시

다음 파일에는 securePassword secretName> 비밀의 최신 값이 있는 매개 변수가< 있습니다..bicepparam

using './main.bicep'

param securePassword = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretPassword')

다음 .bicepparam 파일에는 securePassword secretName 비밀 값<이 있지만 특정 <secretValue>>에 고정된 매개 변수가 있습니다.

using './main.bicep'

param securePassword = getSecret('exampleSubscription', 'exampleResourceGroup', 'exampleKeyVault', 'exampleSecretPassword', 'exampleSecretVersion')

readEnvironmentVariable

readEnvironmentVariable(variableName, [defaultValue])

환경 변수의 값을 반환하거나 환경 변수가 없는 경우 기본값을 설정합니다. 변수 로드는 런타임이 아닌 컴파일 중에 발생합니다.

네임스페이스: sys.

매개 변수

매개 변수	필수	Type	설명
variableName	예	string	변수의 이름입니다.
defaultValue	아니요	string	환경 변수가 없는 경우 사용할 기본 문자열 값입니다.

반환 값

환경 변수의 문자열 값 또는 기본값입니다.

예제

다음 예제에서는 환경 변수의 값을 검색하는 방법을 보여 줍니다.

use './main.bicep'

param adminPassword = readEnvironmentVariable('admin_password')
param boolfromEnvironmentVariables = bool(readEnvironmentVariable('boolVariableName','false'))

다음 단계

Bicep 매개 변수 파일에 대한 자세한 내용은 매개 변수 파일을 참조하세요.