Bicep에 대한 모범 사례

2025-10-30

이 문서에서는 Bicep 파일을 개발할 때 따르는 방법을 권장합니다. 이러한 방법을 통해 Bicep 파일을 더 쉽게 이해하고 사용할 수 있습니다.

학습 리소스

단계별 지침을 통해 Bicep 모범 사례에 대해 알아보려면 협업을 위해 Bicep 코드 구조를 참조하세요.

매개 변수

매개 변수 선언에 적절한 이름을 사용합니다. 좋은 이름을 사용하면 템플릿을 쉽게 읽고 이해할 수 있습니다. 명확하고 설명이 포함된 이름을 사용하고 있으며 명명에 일관성을 유지해야 합니다.
템플릿이 사용하는 매개 변수에 대해 신중하게 생각해야 합니다. 배포 간에 변경되는 설정에 매개 변수를 사용하려고 합니다. 배포 간에 변경되지 않는 설정에는 변수와 하드 코드된 값을 사용할 수 있습니다.
사용할 기본값에 유의해야 합니다. 모든 사용자가 기본값을 안전하게 배포할 수 있는지 확인합니다. 예를 들어 테스트 환경에 템플릿을 배포하는 사용자가 불필요하게 큰 비용이 발생하지 않도록 저렴한 가격 책정 계층 및 SKU를 사용하는 것이 좋습니다.
@allowed 데코레이터를 제한적으로 사용합니다. 이 데코레이터를 너무 광범위하게 사용하는 경우 유효한 배포를 차단할 수 있습니다. Azure 서비스에서 SKU 및 크기를 추가하면 허용된 목록이 최신이 아닐 수 있습니다. 예를 들어 프리미엄 v3 SKU만 허용하면 프로덕션에서 의미가 있을 수 있지만 비프로덕션 환경에서는 동일한 템플릿을 사용할 수 없습니다.
매개 변수의 설명을 제공하는 것이 좋습니다. 설명을 유용하게 만들어 보고 템플릿에 필요한 매개 변수 값에 관한 중요한 정보를 제공합니다.

// 주석을 사용하여 Bicep 파일 내에 메모를 추가할 수도 있습니다.
일반적으로 Bicep 코드를 쉽게 읽을 수 있도록 파일 맨 위에 배치하는 것이 좋지만 템플릿 파일의 아무 곳에나 매개 변수 선언을 배치할 수 있습니다.
이름을 제어하는 매개 변수의 최소 및 최대 문자 길이를 지정하는 것이 좋습니다. 이러한 제한 사항은 나중에 배포하는 동안 오류를 방지하는 데 도움이 됩니다.

Bicep 매개 변수에 대한 자세한 내용은 Bicep의 매개 변수를 참조하세요.

변수

변수를 정의할 때 는 데이터 형식 이 필요하지 않습니다. 변수는 확인 값에서 형식을 유추합니다.
Bicep 함수를 사용하여 변수를 만들 수 있습니다.
Bicep 파일에 변수가 정의되면 변수 이름을 사용하여 값을 참조합니다.

Bicep 변수에 대한 자세한 내용은 Bicep의 변수를 참조하세요.

이름

이름에 카멜식 대/소문자를 사용합니다(예: myVariableName 또는 myResource).
uniqueString() 함수는 고유한 리소스 이름을 만드는 데 유용합니다. 동일한 매개 변수를 제공하면 매번 동일한 문자열을 반환합니다. 리소스 그룹 ID를 전달한다는 것은 동일한 리소스 그룹에 대한 모든 배포에서 문자열이 동일하지만 다른 리소스 그룹 또는 구독에 배포할 때는 다릅니다.
이 예제와 같이 템플릿 식을 사용하여 리소스 이름을 만드는 것이 좋습니다.
```
param shortAppName string = 'toy'
param shortEnvironmentName string = 'prod'
param appServiceAppName string = '${shortAppName}-${shortEnvironmentName}-${uniqueString(resourceGroup().id)}'
```
템플릿 식을 사용하여 리소스 이름을 만들면 다음과 같은 몇 가지 이점이 있습니다.
- 생성된 uniqueString() 문자열은 의미가 없습니다. 템플릿 식을 사용하여 프로젝트 또는 환경 이름의 짧은 설명자와 같은 의미 있는 정보를 포함하는 이름과 임의 구성 요소를 만들어 이름을 고유하게 만드는 것이 유용합니다.
- 함수는 uniqueString() 전역적으로 고유한 이름을 보장하지 않습니다. 리소스 이름에 텍스트를 더 추가하면 기존 리소스 이름을 다시 사용할 가능성이 줄어듭니다.
- 경우에 따라 함수는 uniqueString() 숫자로 시작하는 문자열을 만듭니다. 스토리지 계정과 같은 일부 Azure 리소스의 이름은 숫자로 시작할 수 없습니다. 이 요구 조건은 문자열 보간을 사용해 리소스 이름을 생성하는 것이 좋은 생각입니다. 고유 문자열에 접두사를 추가할 수 있습니다.
- 대부분의 Azure 리소스 종류에는 이름의 허용되는 문자와 길이에 관한 규칙이 있습니다. 템플릿에 리소스 이름 만들기를 포함하면 템플릿을 사용하는 모든 사용자가 이러한 규칙을 따라야 한다는 사실을 기억할 필요가 없습니다.
name를 기호 이름으로 사용하지 마십시오. 기호화된 이름은 리소스 이름이 아니라 리소스를 나타냅니다. 예를 들어 다음 구문 대신 다음 구문을 사용합니다.
```
resource cosmosDBAccountName 'Microsoft.DocumentDB/databaseAccounts@2023-11-15' = {
```
사용:
```
resource cosmosDBAccount 'Microsoft.DocumentDB/databaseAccounts@2023-11-15' = {
```
접미사를 사용하여 변수와 매개 변수를 구분하지 마세요.

리소스 정의

복잡한 식을 리소스 속성에 직접 포함하는 대신 변수를 사용하여 식을 포함합니다. 이 방법을 사용하면 Bicep 파일을 더 쉽게 읽고 이해할 수 있습니다. 논리를 사용하여 리소스 정의를 복잡하게 만들지 않습니다.
리소스의 작동 방식을 가정하는 대신 리소스 속성을 출력으로 사용하려고 합니다. 예를 들어 APP Service 앱에 URL을 출력해야 하는 경우 URL에 대한 문자열을 직접 만드는 대신 앱의 defaultHostname 속성을 사용합니다. 경우에 따라 이러한 가정이 다른 환경에서 올바르지 않거나 리소스가 작동 방식을 변경합니다. 리소스가 고유한 속성을 알려주도록 하는 것이 더 안전합니다.
각 리소스에 대해 최신 API 버전을 사용하는 것이 좋습니다. Azure 서비스의 새로운 기능은 경우에 따라 최신 API 버전에서만 사용할 수 있습니다.
가능하면 Bicep 파일에서 참조 및 resourceId 함수를 사용하지 마세요. 기호화된 이름을 사용하여 Bicep의 모든 리소스에 액세스할 수 있습니다. 예를 들어 기호화된 이름 toyDesignDocumentsStorageAccount를 사용하여 스토리지 계정을 정의하는 경우 식을 toyDesignDocumentsStorageAccount.id사용하여 해당 리소스 ID에 액세스할 수 있습니다. 기호화된 이름을 사용하여 리소스 간에 암시적 종속성을 만듭니다.
명시적 종속성보다 암시적 종속성을 사용하는 것이 좋습니다. dependsOn 리소스 속성을 사용하면 리소스 간에 명시적 종속성을 선언할 수 있지만 일반적으로 해당 기호 이름을 사용하여 다른 리소스의 속성을 사용할 수 있습니다. 이 방법은 두 리소스 간에 암시적 종속성을 만들고 Bicep이 관계 자체를 관리할 수 있도록 합니다.
리소스가 Bicep 파일에 배포되지 않은 경우에도 키워드를 사용하여 리소스에 대한 기호 참조를 existing 가져올 수 있습니다.

자식 리소스

레이어를 너무 깊게 중첩하지 않도록 하십시오. 중첩이 너무 많으면 Bicep 코드를 읽고 작업하기가 더 어려워집니다.
자식 리소스에 대한 리소스 이름을 생성하지 마십시오. Bicep이 리소스 간의 관계를 이해할 때 제공하는 이점을 잃게 됩니다. parent 속성 또는 중첩을 대신 사용합니다.

outputs

중요한 출력이 기록되거나 표시되지 않도록 하는 @secure() 데코레이터를 사용하여 중요한 데이터를 출력에 표시합니다. 그렇지 않으면 배포 기록에 액세스할 수 있는 모든 사용자가 출력 값에 액세스할 수 있습니다.
출력을 통해 속성 값을 전달하는 대신 기존 키워드를 사용하여 이미 존재하는 리소스의 속성을 조회합니다. 출력을 통해 전달하지 않고 다른 리소스의 키를 이런 방식으로 조회하는 것이 가장 좋습니다. 항상 가장 최신 데이터를 얻게 됩니다.

Bicep 출력에 대한 자세한 내용은 Bicep의 출력을 참조하세요.

테넌트 범위

테넌트 범위에서는 정책 또는 역할 할당을 만들 수 없습니다. 그러나 전체 조직에서 액세스 권한을 부여하거나 정책을 적용해야 하는 경우 이러한 리소스를 루트 관리 그룹에 배포할 수 있습니다.

다음 단계

Bicep에 대한 소개는 Bicep 빠른 시작을 참조하세요.
Bicep 파일의 부분에 대한 자세한 내용은 Bicep 파일의 구조 및 구문 이해를 참조하세요.

피드백

이 페이지가 도움이 되었나요?