왜 Azure 팀은 마침내 ARM 템플릿을 떠나고 있는가

By Mirko Peters · 2026-08-27

수년간 Microsoft Azure를 다루는 클라우드 엔지니어와 개발자들은 IaC(Infrastructure as Code)를 도입할 때 씁쓸한 현실에 직면해 왔습니다. 한편으로 Azure Resource Manager(ARM) 템플릿은 클라우드 인프라를 안정적으로 프로비저닝하고 관리할 수 있는 네이티브하고 강력한 방법을 제공했습니다. 다른 한편으로 이러한 템플릿을 작성하고 유지 관리하는 일은 장황한 JSON 파일, 깊은 중첩, 비대해진 코드 구조와 씨름하는 것을 의미했으며, 팀원이 저장소를 건드릴 때마다 고통스러운 병합 충돌이 발생했습니다. 천 줄짜리 JSON 문서에서 잘못 놓인 괄호나 보이지 않는 쉼표를 찾느라 몇 시간을 보낸 적이 있다면, 전통적인 Azure 배포에 따라오는 그 특유의 좌절감을 정확히

Automatically translated with AI from the original post. Read the English original

다행히 클라우드 환경은 발전해 왔습니다. Azure 팀은 원시 ARM 템플릿을 점차 버리고 Bicep으로 옮겨 가고 있습니다. Bicep은 기반 Azure Resource Manager의 신뢰성을 해치지 않으면서 JSON의 고충을 추상화하도록 설계된, 더 깔끔하고 사람이 읽기 쉬운 도메인 전용 언어입니다. 이 종합 가이드에서는 이러한 전환이 왜 일어나고 있는지, Bicep이 내부적으로 어떻게 동작하는지, 그리고 이 전환이 인프라 코드 기반을 최대 60%까지 줄일 수 있는 이유를 살펴보겠습니다.

ARM 템플릿 피로감 개요

Bicep이 Azure 커뮤니티를 강타한 이유를 이해하려면 먼저 ARM 템플릿 피로감의 근본 원인을 진단해야 합니다. Azure가 템플릿 기반 배포를 처음 대중화했을 때 JSON은 데이터 교환의 보편적 표준이었습니다. 하지만 JSON은 프로그래밍 언어나 인프라 정의 도구로 설계된 적이 없습니다. 클라우드 환경이 점점 커지고 정교해지면서 JSON의 한계는 더욱 분명해졌습니다.

기존 ARM 템플릿에서는 복잡성이 기하급수적으로 늘어납니다. 가상 네트워크, 서브넷, 키 자격 증명 모음, 관리 ID를 포함하는 일반적인 엔터프라이즈 배포는 금세 수천 줄에 달하는 비대한 파일로 불어납니다. JSON에는 기본적으로 반복문이나 고급 모듈화 기능이 없기 때문에, 엔지니어들은 복잡한 copy 함수와 지저분한 중첩에 자주 의존하게 됩니다. 여러 팀원이 하나의 거대한 템플릿 파일에서 함께 작업하려고 하면 잦은 병합 충돌은 예외가 아니라 필연이 됩니다. 이러한 파일을 디버깅하는 일은 디지털 건초 더미에서 바늘을 찾는 것과 같아서, 많은 팀이 자동화된 IaC를 포기하고 오류가 잦은 수동 포털 클릭으로 돌아가게 됩니다. 이는 DevOps 자동화의 목적을 완전히 무색하게 만듭니다.

Bicep 개요

이러한 광범위한 개발자 고충을 인식한 Microsoft는 ARM 템플릿 위에 투명한 추상화 계층으로 Bicep을 도입했습니다. Bicep은 Azure Resource Manager를 대체하는 것이 아니라, 이를 다루는 더 똑똑하고 간결한 방식입니다. ARM 템플릿으로 할 수 있는 모든 작업을 Bicep으로도 할 수 있으며, 인지적 부담은 훨씬 적습니다.

Bicep의 핵심에는 일반 영어에 가까운 단순화된 문법이 있습니다. JSON의 문법적 잡음을 걷어내 끝없이 이어지는 따옴표, 괄호, 쉼표와 작별하고, 이를 깔끔한 선언형 구문으로 대체합니다. Bicep은 컴파일 언어이므로 여러분의 코드가 단일 진실 공급원(source of truth) 역할을 하고, 배포 단계에서 표준 ARM JSON으로 변환됩니다. 이 영리한 구조 덕분에 Azure의 기반 배포 엔진과 100% 호환성을 보장하면서도 일상적인 개발자 경험을 크게 개선합니다.

Bicep의 동작 방식

Bicep의 메커니즘을 이해하면 사람이 읽기 쉬운 코드와 기계가 실행하는 코드 사이의 간극을 어떻게 메우는지 분명해집니다. Bicep으로 인프라 코드를 작성할 때는 .bicep 확장명으로 끝나는 파일을 작성합니다. 이 파일들은 Azure 리소스 프로비저닝에 최적화된 도메인 전용 언어를 사용합니다.

작업 흐름은 놀랍도록 간단합니다.

작성: Visual Studio Code와 같은 최신 통합 개발 환경에서 IntelliSense, 구문 검사, 실시간 린팅을 제공하는 풍부한 확장 기능을 활용하여 로컬에서 .bicep 파일을 만들고 편집합니다.
컴파일: Bicep CLI 명령 bicep build main.bicep을 사용하면 깔끔한 코드가 표준 ARM JSON 템플릿으로 컴파일됩니다.
배포: 생성된 템플릿은 평소와 같이 Azure CLI 또는 Azure PowerShell을 사용해 Azure에 직접 배포합니다.

이 컴파일 단계 덕분에 Azure의 핵심 배포 엔진은 그대로 유지되며, 엔터프라이즈 정책, 역할 기반 액세스 제어, 배포 안전 검사도 문제없이 계속 적용됩니다.

Bicep의 장점

JSON 기반 ARM 템플릿에서 Bicep으로 전환하면 엔지니어링 조직은 즉각적이고 측정 가능한 이점을 얻을 수 있습니다. 무엇보다 코드 양이 크게 줄어듭니다. 팀들은 코드가 최대 50%에서 60%까지 줄었다고 자주 보고하며, 이는 작성하고 검토하고 유지 관리해야 할 줄 수가 줄어든다는 뜻입니다.

또한 Bicep은 팀 협업을 크게 향상합니다. 인프라 정의를 더 작고 재사용 가능한 모듈로 나눌 수 있어, 여러 팀원이 서로의 작업을 방해하지 않고 아키텍처의 서로 다른 구성 요소를 동시에 작업할 수 있습니다. 버전 관리가 훨씬 깔끔해지고, 코드 검토는 몇 시간이 아닌 몇 분이면 끝나며, 클라우드 프로젝트에 새로 합류하는 엔지니어도 힘든 시련이 아니라 자연스럽게 적응할 수 있습니다.

Bicep 시작하기

Bicep을 시작하는 데 드는 부담은 매우 적습니다. Bicep CLI는 가볍고 Azure CLI와 기본적으로 통합되어 있어, Windows, macOS 또는 Linux에서 몇 분 안에 바로 사용할 수 있습니다.

먼저 Azure CLI와 Visual Studio Code가 설치되어 있는지 확인합니다. VS Code에 공식 Bicep 확장을 설치하면 코드 완성, 매개 변수 유효성 검사, 리소스 형식 자동 검색 같은 고급 기능을 사용할 수 있습니다. 설정이 끝나면 Azure 스토리지 계정이나 가상 네트워크 같은 첫 리소스를 작성하는 데 몇 줄의 간결한 코드면 충분하며, 수십 줄의 복잡한 JSON 보일러플레이트를 대체할 수 있습니다.

Bicep의 사용 사례

Bicep은 특히 두 가지 주요 엔터프라이즈 시나리오에서 강점을 발휘합니다. 바로 기본적인 Infrastructure as Code(IaC) 구현과 다중 환경 배포입니다.

표준 IaC 파이프라인에서 Bicep은 GitHub Actions 및 Azure DevOps 같은 CI/CD 플랫폼과 무리 없이 통합되어, 구성 드리프트를 없애고 완전히 자동화된 반복 가능한 배포를 가능하게 합니다. 개발, 테스트, 스테이징, 운영과 같은 다중 환경 아키텍처에서는 Bicep의 매개 변수 및 모듈식 템플릿 지원 덕분에 단일하고 표준화된 코드베이스를 유지하면서 환경별 변수와 구성을 필요할 때 안전하게 주입할 수 있습니다.

자주 묻는 질문

Bicep이란 무엇입니까?

Bicep은 Microsoft가 만든 투명한 오픈 소스 도메인 특정 언어로, 기존 ARM 템플릿보다 간결한 구문으로 Azure 리소스를 선언적으로 배포할 수 있게 해 줍니다.

Bicep은 ARM 템플릿과 어떻게 다릅니까?

ARM 템플릿은 읽고 유지 관리하기 어려운 장황한 JSON 구문을 사용하는 반면, Bicep은 간결하고 읽기 쉬운 구문과 고급 도구 지원을 제공합니다. Bicep 파일은 배포 전에 ARM 템플릿으로 컴파일됩니다.

기존 ARM 템플릿을 Bicep으로 변환할 수 있습니까?

네, 가능합니다. Bicep CLI를 사용하면 기존 ARM JSON 템플릿을 Bicep 파일로 쉽게 디컴파일하여 간소화된 구문을 바로 활용할 수 있습니다.

Bicep은 무료로 사용할 수 있습니까?

네, Bicep은 완전히 무료이며 오픈 소스입니다. 또한 Microsoft가 Azure 인프라 관리를 위한 최우선 기능으로 완벽하게 지원합니다.

Bicep은 모듈화를 지원합니까?

물론입니다. Bicep은 처음부터 모듈식 코드 설계를 지원하도록 만들어졌으며, 대규모 인프라 배포를 재사용 가능하고 관리하기 쉬운 구성 요소로 나눌 수 있게 해 줍니다.

레거시 ARM 템플릿을 버리는 것은 더 이상 앞서가는 팀만의 실험적인 선택이 아니라, 효율적이고 확장 가능한 Azure 엔지니어링의 기본 표준이 되어 가고 있습니다. 코드 복잡성을 크게 줄이고, 협업을 강화하며, 다중 환경 배포를 간소화함으로써 Bicep은 클라우드 전문가가 구성 파일과 씨름하기보다 훌륭한 소프트웨어를 만드는 데 집중할 수 있게 해 줍니다.

이 주제를 더 깊이 살펴보고 현대적인 팀이 클라우드 전략을 어떻게 현대화하고 있는지에 대한 실용적인 통찰을 듣고 싶다면, 관련 팟캐스트 에피소드 Bicep - Simply Explained를 꼭 확인해 보세요.