Bicep

Bicep

선언적 구문을 사용하여 Azure Resource를 배포하는 DSL.

• https://learn.microsoft.com/ko-kr/azure/azure-resource-manager/bicep/overview?tabs=bicep

개인적으로 Terraform과 비교가 되어지며 개념이나 작성등은 거의 유사하고 Azure에 특화된 것으로 보여짐.
개인적으로 관심을 가지고 있는 radius에서도 bicep이 사용되는것으로 알고 있어 이에 대해 정리해보기로 함.

installation

binary도 제공하고 있으나 az command 만으로도 사용이 되어져 별도의 설치 없이 az command를 이용하는것을 추천.
https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/install#linux

how to use

script 작성

아래 링크에서 찾을수 있는 azapi 를 사용하며

• https://learn.microsoft.com/en-us/azure/templates/

아래와 같이 각 resource에 대한 format이 제공되어지며 이를 참고하여 작성을 해야 한다.

• aks : https://learn.microsoft.com/en-us/azure/templates/microsoft.containerservice/managedclusters?pivots=deployment-language-bicep

deploy

먼저 resource group을 아래 명령으로 생성하고

$ az group create -n <resourcegroupname> -l <region> 

생성된 resource group을 사용하여 아래와 같이 bicep file을 template-file로 지정하여 배포를 진행한다.

$ az deployment group create -g <resourcegroupname> --template-file 00-main.bicep

배포를 완료하게 되면 아래와 같이 완료 정보가 출력된다.

Name     State      Timestamp                         Mode         ResourceGroup
-------  ---------  --------------------------------  -----------  ---------------
00-main  Succeeded  2023-11-07T06:24:40.189175+00:00  Incremental  <resourcegroupname>

incremental mode는 아래 설명을 참고하면 된다.

• https://learn.microsoft.com/en-us/azure/azure-resource-manager/templates/deployment-modes#incremental-mode

delete

삭제는 위에 incremental mode가아닌 complete mode를 사용하면 된다.

• https://learn.microsoft.com/en-us/azure/azure-resource-manager/templates/deployment-modes#complete-mode

Tips

가급적 bicep script 작성에 visual studio code를 사용하는것을 권장한다.
아래 extension을 설치하게 되면 bicep script상에 이슈가 있는 경우 이를 표기해주고 자동완성도 지원되기 때문이다.

• https://learn.microsoft.com/en-us/azure/azure-resource-manager/troubleshooting/quickstart-troubleshoot-bicep-deployment?tabs=azure-cli#fix-validation-error

Troubleshooting

portal 상에서 bicep으로 배포한 resource group에 가보면 deployments 항목이 있으며 여기에 실패된 내용이 같이 출력되게 된다. (물론 az command로 배포하면서 발생된 에러와 동일한 수준이다.)

• https://learn.microsoft.com/en-us/azure/azure-resource-manager/troubleshooting/quickstart-troubleshoot-bicep-deployment?tabs=azure-cli#fix-deployment-error

Examples

• https://github.com/jacobbaek/azbcdeploy/tree/main/deployAKSwithAppGW