본문으로 건너뛰기
Cloudflare 계정의 설정 실수를 배포 전에 잡는 IaC
목차

Cloudflare 계정의 설정 실수를 배포 전에 잡는 IaC (2025-12)

원문 정보

몇 초 만에 엣지 전체로 퍼지는 설정 실수

Cloudflare에서는 설정 실수 하나가 몇 초 안에 엣지 전체로 퍼질 수 있습니다. 모든 직원이 핵심 애플리케이션에 접근하지 못하거나 프로덕션 서비스가 멈출 수도 있습니다. 변경을 배포하기 직전에 느끼는 긴장감은, 자사 제품으로 자사 서비스를 보호하고 최적화하는 Cloudflare에도 익숙한 일이었습니다.

보안 부문의 Customer Zero 팀은 제품을 직접 사용하면서 제품·엔지니어링 팀에 지속적으로 피드백을 줍니다. 이 팀이 풀어야 할 과제는 수백 개 내부 프로덕션 계정의 보안 설정을 일관되게 유지하면서 사람의 실수를 줄이는 일이었습니다. 대시보드는 관측과 분석에 유용했습니다. 하지만 수백 개 계정을 일일이 클릭하며 설정을 확인하는 작업에는 실수가 따르기 마련이었습니다.

팀은 설정을 코드로 관리하고 검증 시점을 개발 초기로 옮겼습니다. 테스트와 보안 감사, 정책 준수 검사를 CI/CD에 넣어 머지 요청 단계에서 문제를 발견하는 ‘shift left’입니다. 배포 후보다 수정 비용이 낮은 시점입니다. Customer Zero 팀에게 이 전환은 추상적인 기업 목표가 아닌, 오류가 사고로 이어지기 전에 잡아내기 위한 생존 수단이었습니다.

머지 요청 안의 OPA 정책 검사

배포 전에 검사하려면 무엇을 허용할지부터 정해야 합니다. Cloudflare는 모든 내부 프로덕션 계정에 적용할 보안 기준선을 코드로 정의했습니다. 최대 세션 길이, 필수 로그, 특정 WAF 설정 등이 여기에 포함됩니다. 참고용 권고가 아닌 필수 보안 설정입니다.

검사는 Open Policy Agent(OPA)와 정책 언어 Rego를 사용하는 Atlantis의 Conftest 정책 검사 기능이 맡습니다. 작성 당시 유지하던 정책은 약 50개였습니다. 예를 들어 접근 정책인 cloudflare_access_policy의 include와 require에 지정한 이메일을 검사해, @cloudflare.com으로 끝나지 않으면 경고하는 정책이 있습니다.

검사는 머지 요청(MR)마다 실행됩니다. 결과는 GitLab MR 댓글에 표시되며, 기준선을 벗어난 리소스를 구체적으로 알려 줍니다. 경고 모드는 댓글을 남기되 머지를 허용합니다. 거부 모드에서는 배포를 차단합니다.

검사 출력 예시에는 세션 지속 시간이 10시간 이하여야 한다는 경고와 auth_method = "swk"인 require 구문이 적어도 하나 있어야 한다는 경고가 나옵니다. 41개 테스트 중 38개가 통과했고 경고는 3건, 실패는 0건이었습니다. 경고와 배포 차단을 구분하는 방식이 결과에도 드러납니다.

승인된 예외의 범위를 담은 exceptions.rego

정책을 강제해도 예외는 필요합니다. Cloudflare는 예외에도 정책과 같은 수준의 관리 절차를 적용했습니다. 예외가 필요한 팀은 Jira로 요청하고, Customer Zero 팀의 승인을 받으면 중앙 exceptions.rego 저장소에 풀 리퀘스트를 제출해 반영합니다.

예외는 필요한 범위에 맞춰 지정합니다. 특정 계정을 특정 정책에서 제외하거나, 그 계정 안의 특정 리소스 범주 전체를 제외하거나, 리소스 하나만 제외하는 방식입니다. 원문에 실린 세션 길이 예외는 서로 다른 계정 2개에 속한 애플리케이션 5개를 대상으로 합니다. 계정 ID와 Terraform 주소를 코드에 명시해 예외가 적용되는 대상을 기록했습니다.

각 팀이 책임지는 Terraform 모노레포

보안 정책은 중앙에서 정하지만, 설정을 구현하고 배포하는 주체는 각 엔지니어링 팀입니다. 모든 내부 계정 설정은 중앙 모노레포에 모으고, 팀마다 담당 구간의 코드 오너가 되도록 했습니다. 설정을 계정 간에 쉽게 복사·재사용하고 여러 계정에 큰 변경을 빠르게 적용하는 것, 누구나 현재 상태와 정확성·보안을 감사할 수 있게 하는 것이 운영 원칙이었습니다.

Cloudflare는 모든 프로덕션 계정을 Infrastructure as Code(IaC)로 관리하도록 전환했습니다. 중요한 프로덕션 변경은 코드로 수행하고, 모든 변경에 사용자·커밋·내부 티켓을 연결하며 동료 검토를 거치게 했습니다. 팀은 여전히 대시보드에서 분석과 인사이트를 얻습니다.

이 운영 모델의 기반으로 Terraform을 선택했습니다. 성숙한 오픈소스 생태계와 커뮤니티 지원, Policy as Code 도구와의 긴밀한 통합이 선택 이유였습니다. Cloudflare Terraform Provider를 내부에서 직접 사용하면 고객이 겪는 사용 경험도 개선할 수 있었습니다. 수백 개 계정과 하루 약 30건의 MR을 처리하는 CI/CD는 GitLab과 연동한 Atlantis로 운영합니다.

상태 파일 저장에는 별도 장치를 뒀습니다. Go로 만든 tfstate-butler가 Terraform의 HTTP 백엔드이자 상태 파일을 안전하게 저장하는 브로커로 동작합니다. 상태 파일마다 고유한 암호화 키를 사용하는 이유는 침해가 발생했을 때 영향 범위를 제한하기 위해서입니다.

중앙 보안 기준선, 동료 검토, 배포 전 정책 검사는 설정 오류와 실수로 인한 삭제, 정책 위반 가능성을 줄였습니다. Cloudflare는 이 방식이 엔지니어링 속도도 높였다고 설명합니다. 팀이 자신의 변경이 정책을 준수한다는 확신을 얻었기 때문입니다.

달리는 차의 타이어를 바꾸는 IaC 전환

운영 모델을 정해도 기존 설정이 저절로 코드가 되지는 않았습니다. 수년간 대시보드에서 직접 변경한 설정이 수백 개 계정에 흩어져 있었습니다. 이를 엄격한 IaC 체계로 가져오는 작업은 달리는 차의 타이어를 바꾸는 것 같았습니다. 글을 쓴 시점에도 리소스 임포트는 진행 중이었습니다.

팀에는 Terraform 리소스와 import 블록을 직접 작성하거나 cf-terraforming을 사용하는 선택지가 있었습니다. 수동 임포트의 학습 곡선은 예상보다 가팔랐습니다. 팀마다 Terraform 숙련도가 달랐기 때문입니다. cf-terraforming은 Cloudflare API를 사용해 필요한 Terraform 코드와 import 구문을 자동 생성했고, 마이그레이션을 크게 앞당겼습니다. 숙련된 엔지니어가 provider의 세부 동작을 안내하고 복잡한 임포트를 돕는 내부 커뮤니티도 만들었습니다.

자사 도구의 한계도 드러났습니다. 수백 개 계정을 관리하는 규모에서야 나타나는 Cloudflare Terraform provider의 엣지 케이스가 있었습니다. Customer Zero 팀에는 자사 제품을 직접 운영해야 하는 이유를 확인하는 경험이었습니다.

제품과 API가 빠르게 늘어나는 속도를 Terraform provider가 따라가지 못하는 문제도 있었습니다. Cloudflare는 OpenAPI 명세에서 provider를 자동 생성하는 v5 provider를 출시해 이 문제를 해결했습니다. 코드 생성 방식을 다듬는 과정은 순탄하지 않았습니다. 그럼에도 API와 Terraform을 동기화하고 기능 격차가 생길 가능성을 줄이는 방식으로 전환했습니다.

긴급 수정 뒤의 Terraform 드리프트

배포 전 검사를 마련한 뒤에도 실제 설정과 코드가 어긋나는 일은 생겼습니다. 장애 중에는 대시보드에서 바로 수정하는 편이 빠릅니다. 급한 변경을 위해 IaC 절차를 우회하면 Terraform 상태가 실제 배포 상태를 반영하지 못하는 드리프트가 남습니다.

Cloudflare는 Terraform이 정의한 상태와 Cloudflare API로 확인한 실제 상태를 계속 비교하는 자체 감지 서비스를 만들었습니다. 드리프트를 발견하면 자동으로 내부 티켓을 생성해 해당 설정을 소유한 팀에 배정합니다. 복구에는 서로 다른 서비스 수준 협약(SLA)을 적용해, 긴급 변경 뒤에 남은 불일치도 담당 팀이 처리하도록 했습니다.

운영 규모와 정책 구성
항목값
관리 대상수백 개 내부 프로덕션 Cloudflare 계정
머지 요청하루 약 30건
Rego 정책 수약 50개
CI/CDAtlantis + GitLab
상태 저장tfstate-butler (상태 파일별 고유 암호화 키)
정책 강제 모드경고(머지 허용), 거부(배포 차단)
예외 범위계정, 리소스 범주, 특정 리소스
예시 정책세션 지속 시간 10시간 이하
예시 검사 결과41개 테스트, 38개 통과, 경고 3건, 실패 0건
마지막 수정 일자