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 | 환경 변수가 없는 경우 사용할 기본 문자열 값입니다. |
반환 값
환경 변수의 문자열 값 또는 기본값입니다.
설명
다음 명령은 실행 중인 PowerShell 프로세스에 대해서만 환경 변수를 설정합니다. Visual Studio Code에서 BCP338을 가져옵니다.
$env:testEnvironmentVariable = "Hello World!"
사용자 수준에서 환경 변수를 설정하려면 다음 명령을 사용합니다.
[System.Environment]::SetEnvironmentVariable('testEnvironmentVariable','Hello World!', 'User')
컴퓨터 수준에서 환경 변수를 설정하려면 다음 명령을 사용합니다.
[System.Environment]::SetEnvironmentVariable('testEnvironmentVariable','Hello World!', 'Machine')
자세한 내용은 Environment.SetEnvironmentVariable 메서드를 참조 하세요.
예제
다음 예제에서는 환경 변수의 값을 검색하는 방법을 보여 줍니다.
use './main.bicep'
param adminPassword = readEnvironmentVariable('admin_password')
param boolfromEnvironmentVariables = bool(readEnvironmentVariable('boolVariableName','false'))
다음 단계
Bicep 매개 변수 파일에 대한 자세한 내용은 매개 변수 파일을 참조하세요.