Cloudflare 설정 관리를 단일 진실에 통합

Cloudflare 토큰과 설정 정보를 ops SSOT(Single Source of Truth) 문서에 명시적인 포인터로 추가했다.

배경 — 왜 중앙화가 필요한가

인프라를 관리하다 보면 설정 정보가 이곳저곳에 흩어진다. 개발 초기에는 한두 곳에서 관리했지만, 팀이 커지고 문서가 늘어나면서 자연스럽게 분산되기 시작한다. Cloudflare 같은 외부 서비스의 토큰이나 설정 링크도 마찬가지다. 보안, 인프라, 개발 담당자마다 다른 문서에서 참조하거나 로컬 노트에 보관하면서 이런 문제가 생긴다:

• 갱신 누락: 정책이 바뀌어도 한곳만 수정되고 다른 참조 문서는 방치됨
• 일관성 깨짐: 팀 신입이 옛 정보를 참조하거나 여러 버전이 공존
• 보안 리스크: 누가 뭘 관리하는지 불명확해서 권한/갱신 주기 관리 어려움
• 온보딩 시간 증가: 새로운 팀원이 "어디서 이 설정을 찾지?" 하며 헤맴

이런 상황을 막기 위해 단일 진실을 정하는 게 핵심이다.

어떻게 개선했는가

docs/hedvion-CLAUDE.md 에 ops SSOT 로의 포인터를 명시적으로 추가했다. 즉:

포인터 방식이 중요한 이유는, 실제 설정 정보가 변해도 참조 경로는 안 바뀐다는 점이다. 누군가 ops SSOT 를 업데이트하면, 모든 문서가 자동으로 최신 정보를 참조하게 된다. 즉 "문서를 여러 개 수정할 필요가 없다"는 뜻이다.

일반론 — 설정 관리의 패턴

큰 팀이나 여러 서비스를 운영할 때 중앙 집중식 관리는 다음 몇 가지를 보장한다:

• 책임 소재 명확: "이건 누가 관리해?" 했을 때 SSOT 를 보면 답이 나옴
• 버전 관리: 한 곳만 수정하면 되므로 git history 추적이 간단
• 이동성: 나중에 저장소를 옮기거나 구조를 바꿀 때 포인터만 수정하면 됨
• 감사(Audit): "언제 누가 뭘 바꿨나" 를 한곳에서 추적 가능

많은 팀들이 설정 관리를 놓친다. "암묵적 지식"으로 남아있거나, "내 노트에만 있어" 식으로 관리하다가 나중에 문제를 겪는다. 특히 보안 관련 정보(토큰, 키)가 흩어져 있으면 회전율도 낮아지고 갱신 일정을 놓치기 쉽다.

회고 — 배운 것과 앞의 개선

이 작업을 하면서 깨달은 건, "문서를 쓰는 것"과 "문서의 참조를 설계하는 것"은 다르다는 점이다. 단순히 "Cloudflare 설정은 이렇다"라고 쓰는 것도 중요하지만, "누가 이 정보를 알아야 하고, 어디에서 찾을 것인가"를 먼저 정하는 게 더 중요하다는 뜻이다.

특히 팀이 커질수록, 또는 여러 팀이 같은 인프라를 사용할수록 이런 구조화가 필수다. 포인터 중심의 문서 구조는 처음엔 조금 번거로워 보이지만, 6개월 뒤에 누군가 "이거 어디에..." 하며 물었을 때 "ops SSOT 를 봐" 한 줄이면 끝난다.

앞으로도 인프라 정책이나 설정이 추가될 때마다 "어디가 SSOT 인가" 를 먼저 정하고, 모든 참조는 그곳을 향하도록 할 계획이다.

🛒 이 글과 어울리는 추천 상품

• 모니터 쿠팡에서 보기 →
• 사무의자 쿠팡에서 보기 →
• 기계식키보드 쿠팡에서 보기 →

*위 링크는 쿠팡파트너스 활동의 일환이며, 일정액의 수수료를 제공받을 수 있습니다.