Microsoft Graph Bicep 리소스에 동적 형식 사용
Microsoft Graph Bicep 확장은 Microsoft Graph 베타 및 v1.0 모두에 대한 의미 체계 버전 관리가 가능한 동적 형식을 사용합니다. 동적 형식을 사용하면 이전 버전의 리소스 종류를 사용하는 기존 Bicep 파일의 배포에 영향을 주지 않고 기존 Microsoft Graph Bicep 리소스 형식의 향후 호환성이 손상되는 변경이 가능합니다. 동적 형식을 사용하는 경우 특정 버전이 지정된 Microsoft Graph Bicep 형식 리포지토리가 Microsoft 아티팩트 레지스트리 참조되고 페치됩니다. 이러한 형식 버전은 Bicep 컴파일러 NuGet 패키지에서 분리됩니다.
main.bicep 파일 내에서 직접 또는 main.bicep 파일에서 참조할 수 있는 bicepconfig.json 파일에서 사용자에게 친숙한 형식 버전 별칭을 사용하여 동적 형식을 구성하는 두 가지 방법이 있습니다.
형식 버전 선택
Microsoft 아티팩트 레지스트리 Microsoft Graph Bicep 리소스 유형 리포지토리에 대한 참조를 추가해야 합니다. 최신 또는 적절한 리포지토리 버전을 찾으려면 Microsoft 아티팩트 레지스트리 이동하여 "Microsoft Graph Bicep 확장"을 검색합니다. Microsoft Graph 베타 및 v1.0 버전이 있습니다.
Bicep 파일에서 동적 형식 구성
main.bicep 파일에서 사용할 Microsoft Graph Bicep 형식 리포지토리 버전을 참조하여 자리 표시자를 Microsoft Graph v1.0에 사용할 형식 버전으로 바꿀 <v1.0-version> 수 있습니다.
extension 'br:mcr.microsoft.com/bicep/extensions/microsoftgraph/v1.0:<v1.0-version>'
동일한 Bicep 파일에서 베타 버전을 지정한 다음 두 버전의 형식을 모두 사용할 수도 있습니다.
extension 'br:mcr.microsoft.com/bicep/extensions/microsoftgraph/v1.0:<v1.0-version>'
extension 'br:mcr.microsoft.com/bicep/extensions/microsoftgraph/beta:<beta-version>'
// using Microsoft Graph v1.0
resource group 'Microsoft.Graph/groups@v1.0' existing = {
uniqueName: groupName
}
// using Microsoft Graph beta
resource app 'Microsoft.Graph/applications@beta' existing = {
uniqueName: appName
}
또한 이전 및 최신 Bicep 형식 버전을 사용하는 리소스를 선언할 수 있습니다. 이 예제에서는 이전 형식과 최신 형식을 사용하는 방법을 보여줍니다. 정규화된 형식 이름을 사용하여 가져온 두 확장에서 사용할 수 있는 동일한 이름의 형식을 구분합니다.
extension 'br:mcr.microsoft.com/bicep/extensions/microsoftgraph/v1.0:<v1.0-version-latest>' as latestGraphV1
extension 'br:mcr.microsoft.com/bicep/extensions/microsoftgraph/v1.0:<v1.0-version-older>' as olderGraphV1
// using the latest version of the Microsoft Graph v1.0 Bicep types
resource group 'latestGraphV1:Microsoft.Graph/groups@v1.0' existing = {
uniqueName: groupName
}
// using and older version of the Microsoft Graph v1.0 Bicep types
resource app 'olderGraphV1:Microsoft.Graph/applications@v1.0' existing = {
uniqueName: appName
}
Bicep 구성에서 동적 형식 구성
bicepconfig.json 파일에서 사용할 Microsoft Graph Bicep 형식 리포지토리 버전을 참조하는 사용자에게 친숙한 별칭을 지정하여 자리 표시자와 자리 표시자를 사용하려는 형식 버전으로 바꿀 <v1.0-version> <beta-version> 수 있습니다.
{
"experimentalFeaturesEnabled": {
"extensibility": true
},
"extensions": {
"graphV1": "br:mcr.microsoft.com/bicep/extensions/microsoftgraph/v1.0:<v1.0-version>",
"graphBeta": "br:mcr.microsoft.com/bicep/extensions/microsoftgraph/beta:<beta-version>"
}
}
그런 다음 사용할 확장을 지정할 때 main.bicep 파일에서 이러한 별칭을 사용할 수 있습니다. 표시된 것처럼 Microsoft Graph v1.0 및 Microsoft Graph 베타 버전에서 리소스를 선언할 수 있는 v1.0 및 베타 확장 사용을 선언할 수 있습니다.
extension graphV1
extension graphBeta
// using Microsoft Graph v1.0
resource group 'Microsoft.Graph/groups@v1.0' existing = {
uniqueName: groupName
}
// using Microsoft Graph beta
resource app 'Microsoft.Graph/applications@beta' existing = {
uniqueName: appName
}
참고 항목
또한 bicepconfig.json 파일에서 동일한 Microsoft Graph 버전(예: Microsoft Graph v1.0의 최신 및 이전 Bicep 형식 버전)에서 다른 형식 버전의 별칭을 선언하고 확장을 가져오고 정규화된 형식 이름을 사용하여 리소스를 선언할 때 main.bicep 파일에서 해당 별칭을 참조할 수 있습니다.
기본 제공 형식에서 동적 형식 사용으로 마이그레이션
Microsoft Graph Bicep 형식은 Bicep 컴파일러 NuGet 패키지에도 기본 제공됩니다. 이 NuGet 패키지에는 Microsoft Graph 베타 및 v1.0 모두에 대한 Microsoft Graph 형식 정의가 포함되어 있습니다. 기본 제공 형식은 2024년 9월 이전에 사용할 수 있는 유일한 옵션이었습니다.
Important
기본 제공 형식은 더 이상 사용되지 않으며 2025년 1월 24일에 사용 중지됩니다. 사용 중지 날짜까지 기본 제공 형식 extension microsoftGraph은 새 동적 형식과 공존합니다. 모든 Microsoft Graph Bicep 형식 변경 내용은 새 버전의 동적 형식을 통해서만 사용할 수 있습니다.
기본 제공 형식에서 동적 형식으로 전환합니다.
VS Code를 시작하고 main.bicep 및 bicepconfig.json 파일이 포함된 폴더를 엽니다.
main.bicep 파일에는 기본 제공 확장명 아래에 경고가
microsoftGraph표시됩니다. 경고 위로 커서를 가져가서 세부 정보를 확인합니다.
이 문제를 해결하려면 경고 세부 정보의 맨 아래에 있는 빠른 수정 링크를 선택합니다.