using 및 using none 문

A using 또는 using none 선언은 모든 Bicep 매개 변수 파일에 있어야 합니다.

Bicep 매개 변수 파일은 일반적으로 문을 사용하여 using파일을 Bicep 파일, ARM 템플릿(JSON Azure Resource Manager 템플릿),Bicep 모듈 또는 템플릿 사양에 연결합니다. 이 연결을 사용하면 Bicep 언어 서버와 컴파일러가 매개 변수 파일의 유효성을 검사하여 템플릿의 입력에 따라 올바른 이름, 형식 및 필수 값을 확인할 수 있습니다.

반면, using none 이 문은 매개 변수 파일이 컴파일 시간에 특정 템플릿에 연결되지 않음을 명시적으로 나타냅니다. 즉, 매개 변수는 특정 템플릿에 대해 유효성을 검사하지 않으며 대신 외부 도구에서 사용되거나 재사용 가능한 공유 매개 변수 집합으로 사용되는 등 보다 일반적인 용도로 사용됩니다.

using 문

using 명령문의 구문:

• Bicep 파일을 사용하려면:

  using '<path>/<file-name>.bicep'
  

• JSON ARM 템플릿을 사용하려면:

  using '<path>/<file-name>.json'
  

• 공용 모듈을 사용하려면:

  using 'br/public:<file-path>:<tag>'
  

  예를 들면 다음과 같습니다.

  using 'br/public:avm/res/storage/storage-account:0.9.0' 
  
  param name = 'mystorage'
  

• 프라이빗 모듈을 사용하려면:

  using 'br:<acr-name>.azurecr.io/bicep/<file-path>:<tag>'
  

  예를 들면 다음과 같습니다.

  using 'br:myacr.azurecr.io/bicep/modules/storage:v1'
  

  bicepconfig.json 파일에 정의된 별칭이 있는 프라이빗 모듈을 사용하려면:

  using 'br/<alias>:<file>:<tag>'
  

  예를 들면 다음과 같습니다.

  using 'br/storageModule:storage:v1'
  

• 템플릿 사양을 사용하려면:

  using 'ts:<subscription-id>/<resource-group-name>/<template-spec-name>:<tag>
  

  예를 들면 다음과 같습니다.

  using 'ts:00000000-0000-0000-0000-000000000000/myResourceGroup/storageSpec:1.0'
  

  bicepconfig.json 파일에 정의된 별칭과 함께 템플릿 사양을 사용하려면:

  using 'ts/<alias>:<template-spec-name>:<tag>'
  

  예를 들면 다음과 같습니다.

  using 'ts/myStorage:storageSpec:1.0'
  

using none 문

Bicep 매개 변수 파일(.bicepparam)의 문은 using none 작성 또는 컴파일 중에 파일이 특정 Bicep 템플릿에 연결되지 않음을 나타냅니다. 이렇게 하면 매개 변수 파일을 특정 템플릿에서 분리하여 배포에서 매개 변수를 정의하고 사용하는 방법에 대한 유연성이 향상됩니다.

using none 문장의 구문:

using none

이 문은 특정 템플릿이 참조되지 않음을 알리기 위해 Bicep 매개 변수 파일의 시작 부분에 배치됩니다.

Bicep의 using none 주요 이점은 매개 변수 파일이 일반화, 공유 또는 템플릿과 동적으로 통합되는 시나리오에 있습니다. 일반적인 사용 사례는 다음과 같습니다.

• 중앙 집중식 매개 변수 리포지토리

  조직은 종종 여러 Bicep 배포에서 사용되는 기본 지역, 명명 규칙 또는 전역 태그와 같은 표준 매개 변수 값을 유지 관리합니다. 없음을 사용하는 Bicep 매개 변수 파일은 이러한 공유 값의 중앙 저장소 역할을 하여 일관성을 개선하고 중복을 최소화할 수 있습니다. 그런 다음 이러한 매개 변수를 배포 시 템플릿별 값과 프로그래밍 방식으로 병합할 수 있습니다.

  예를 들어 공유 Bicep 매개 변수 파일은 다음을 정의할 수 있습니다.

  using none
  
  param ___location = 'westus2'
  param environmentTag = 'production'
  param projectName = 'myApp'
  

• 동적 생성 및 런타임 통합

  CI/CD 파이프라인 또는 자동화 스크립트에서 매개 변수 파일은 즉석에서 만들거나 런타임에 템플릿과 연결될 수 있습니다. 고정 템플릿 참조 using none 를 생략하면 이러한 파일을 유연하고 다양한 배포 컨텍스트에 맞게 조정할 수 있습니다.

Bicep 매개 변수 파일에 지정된 경우 using none 컴파일러는 특정 Bicep 템플릿에 대해 매개 변수의 유효성을 검사하지 않습니다. 즉, 연결된 템플릿이 없어서 일치하지 않는 이름이나 형식에 대한 컴파일 시간 경고 또는 오류가 발생하지 않습니다. 그러나 이 분리는 작성 및 컴파일 중에만 적용됩니다. 배포 시 ARM(Azure Resource Manager)에는 여전히 Bicep 템플릿과 매개 변수 파일이 모두 필요합니다. ARM 엔진은 대상 템플릿에 정의된 매개 변수에 대해 파일의 매개 변수를 확인하여 배포 중에 유효성 검사를 수행합니다.

다음 단계

• Bicep 배포용 매개 변수 파일 만들기에서 Bicep 매개 변수 파일에 대해 알아봅니다.
• Bicep 환경 구성에서 bicepconfig.json 파일에 별칭을 구성하는 방법에 대해 알아봅니다.