코드형 인프라와 GitOps
코드형 인프라는 서버, 네트워크, 클라우드 리소스를 도구가 적용하는, 검토된 텍스트 파일로 정의합니다. GitOps는 저장소가 라이브 시스템을 바꾸는 유일한 방법이며 컨트롤러가 현실이 그것과 일치하도록 유지한다는 규칙을 더해, 버전 관리가 변경의 기록이자 복구의 수단이 되게 합니다.
왜 중요한가
오랫동안 인프라는 손으로 만들어졌습니다. 엔지니어가 서버에 로그인해 패키지를 설치하고, 구성을 편집하고, 다음 일로 넘어갔습니다. 서버는 이력이 엔지니어의 기억과 몇 개의 메모에 있는 유일무이한 대상이 되었습니다. 서버가 실패하면 기억에 의존해 다시 만들었습니다. 두 번째 서버가 필요하면 아무도 나열할 수 없는 작은 점에서 다른 복사본이 되었습니다. 문제 해결은 "동일한" 두 시스템이 어떻게 다르게 행동하게 되었는지 알아내는 일이었습니다.
코드형 인프라(IaC)는 이를 텍스트로 대체합니다. 인프라의 원하는 상태를 파일에 쓰고, 버전 관리에 보관하고, 소프트웨어처럼 검토하고, 도구로 적용합니다. 환경을 다시 만드는 일은 명령 하나가 됩니다. 두 번째 복사본은 값만 다른 같은 파일입니다. 변경은 검토자, 시험, 기록이 있는 풀 리퀘스트입니다. Wikipedia는 코드형 인프라를 대화형 구성이 아니라 기계가 읽을 수 있는 정의 파일을 통한 인프라의 관리와 프로비저닝으로 설명합니다.
GitOps는 이 생각을 한 걸음 더 나아가게 합니다. 저장소가 원하는 상태에 대한 단일 진실의 원천으로 선언되고, 소프트웨어가 저장소와 라이브 시스템을 모두 지켜보며 시스템을 일치시킵니다. 아무도 운영 환경을 손으로 바꾸지 않고, 저장소를 바꿉니다. 이는 서비스 관리에 많은 것을 줍니다. 모든 변경의 감사 추적, 빠른 복구, 환경 간 일관성, 변경 승인의 자연스러운 집입니다. 또한 저장소의 비밀, 모든 곳에 한꺼번에 적용되는 실수 같은 새로운 위험도 들여옵니다. 이 주제는 생각과 이를 신중하게 도입하는 방법을 설명합니다. 구성 관리(주제 4.4 — 구성 관리), 지속적 전달(주제 2.2 — 지속적 전달), 변경 실현(주제 3.4 — 변경 실현) 위에 서 있으며, 파이프라인(주제 6.4 — 파이프라인과 자동화된 변경)으로 이어집니다.
핵심 개념
코드형 인프라(IaC). 도구가 읽고 적용하는 코드나 구성 파일로 인프라를 정의하는 것입니다. 서버, 네트워크, 스토리지, 데이터베이스, 접근 규칙, 플랫폼 설정을 포괄합니다. Wikipedia가 이 접근과 역사를 설명합니다. 파일은 메커니즘이자 문서입니다.
선언형과 명령형. 선언형 정의는 최종 상태가 어때야 하는지를 진술하고("이 로드 밸런서 뒤에 이 유형의 서버가 세 대 있다"), 도구가 거기에 이르는 방법을 알아냅니다. 명령형 정의는 취할 단계를 진술합니다. Wikipedia가 선언형 및 명령형 프로그래밍을 설명합니다. 선언형 도구는 추론하고 안전하게 반복하기가 더 쉬운 경향이 있고, 명령형 스크립트는 특이한 작업에 더 많은 통제를 줍니다. 많은 팀이 둘 다 씁니다.
도구. 예로는 클라우드 리소스를 프로비저닝하는 Terraform, 시스템을 구성하는 Ansible, 선언된 매니페스트에 따라 컨테이너를 실행하는 Kubernetes가 있습니다. Wikipedia가 각각을 설명합니다. 도구 지형은 빠르게 바뀝니다. 적합성, 지원, 보유한 스킬로 고르고, 정의를 실용적인 만큼 이식 가능하게 유지하세요.
원하는 상태, 실제 상태, 드리프트. 원하는 상태는 코드가 말하는 것이고, 실제 상태는 실행 중인 것입니다. 드리프트는 그 차이로, 대개 수동 변경이나 실패에서 옵니다. 드리프트를 탐지하고 바로잡는 것이 IaC의 핵심 편익입니다. 주제 4.4 — 구성 관리를 참조하세요.
멱등성. 같은 정의를 반복해서 적용해도 같은 결과가 나옵니다. Wikipedia가 멱등성을 설명합니다. 드리프트를 바로잡기 위해 적용을 다시 실행해도 안전하게 만드는 것이 이것입니다.
상태 파일. 일부 도구는 관리하는 리소스의 기록을 보관하고 정의와 비교합니다. 조심해서 다루세요. 민감한 데이터를 담을 수 있고, 손으로 편집해서는 안 되며, 두 사람이 동시에 적용하지 않도록 잠금이 필요합니다.
불변 인프라. 실행 중인 서버를 바꾸는 대신, 알려진 이미지로 새 서버를 만들어 옛 서버를 교체합니다. 드리프트를 피하고 롤백을 단순하게 만듭니다. 되돌아가기만 하면 됩니다. Wikipedia가 설명하는 가상 머신과 컨테이너, 잘 만든 이미지와 함께 가장 잘 작동합니다.
버전 관리와 검토. 정의는 Wikipedia가 분산 버전 관리 시스템으로 설명하는 Git 같은 버전 관리에 있습니다. 변경은 풀 리퀘스트와 코드 검토로 설명되는 브랜치와 검토를 거칩니다. 이력은 누가 무엇을 언제 왜 바꿨는지 보여 주며, 감사와 학습을 뒷받침합니다. 주제 3.4 — 변경 실현을 참조하세요.
GitOps. Git 저장소가 원하는 상태를 담고 자동화된 에이전트가 라이브 시스템을 그것에 일치시키는 운영 접근입니다. 변경은 저장소를 바꾸는 것으로만 이루어지고, 에이전트가 가져와 적용하며 수동 변경은 되돌립니다. Wikipedia는 DevOps 항목에서 GitOps를 언급합니다. 풀 기반 설계는 운영 시스템이 자신의 구성을 가져오므로 운영 환경의 자격 증명이 빌드 시스템에 있을 필요가 없다는 뜻입니다. 접근의 세부는 프로젝트 자체 문서를 확인하세요.
조정 루프. 원하는 상태와 실제 상태를 반복해서 비교하고 간극을 메우도록 행동하는 컨트롤러입니다. 이 생각은 Wikipedia가 설명하는 제어 이론에서 왔으며, Kubernetes와 GitOps 도구가 작동하는 방식의 바탕입니다. 루프는 탄력적이지만, 나쁜 변경을 빠르게 반복할 수도 있습니다.
환경과 승격. 값만 다른 같은 정의가 개발, 시험, 운영 환경을 만듭니다. 변경은 이들을 거쳐 승격됩니다. 환경을 일관되게 유지하면 시험이 더 의미 있어집니다. 주제 3.5 — 릴리스와 배포 관리를 참조하세요.
코드형 정책. "공개 스토리지 금지"나 "모든 리소스에 태그 필수"처럼 허용되는 것에 대한 규칙을 코드로 써서 변경이 적용되기 전에 자동으로 점검하는 것입니다. 통제를 변경이 이루어지는 곳에 두고 증거를 만들어 냅니다. 주제 6.4 — 파이프라인과 자동화된 변경을 참조하세요.
비밀. 비밀번호, 키, 토큰을 저장소에 평문으로 저장해서는 안 됩니다. 비밀 관리자나 암호화를 쓰고, 자동화에 최소한의 짧은 수명의 접근을 주세요. 주제 3.13 — 정보 보안 관리를 참조하세요.
모듈과 재사용. 표준 네트워크나 데이터베이스 같은 흔한 패턴을 위한 공유되고 시험된 모듈은 작업 속도를 높이고 표준을 강제합니다. 오너, 버전, 릴리스 노트가 필요합니다.
피해 반경. 공유 정의의 실수는 많은 시스템에 한꺼번에 영향을 줄 수 있습니다. 상태를 더 작은 단위로 나누고, 단계적 롤아웃을 쓰고, 공유 모듈에 검토를 요구해 이를 제한하세요.
인프라 코드 시험하기. 방법으로는 문법 및 정책 점검, 적용 전 변경의 계획이나 미리 보기, 일회용 환경에서의 시험, 적용 후 점검이 있습니다. Wikipedia가 시험 자동화 아래 관련된 생각을 설명합니다. 주제 2.2 — 지속적 전달을 참조하세요.
렌즈는 어떻게 맞물리는가. IaC와 GitOps는 애자일 운영의 엔지니어링 기반입니다. 작고, 검토되고, 되돌릴 수 있는 변경입니다. AI는 검토 아래 정의의 초안을 쓰고 계획을 설명할 수 있습니다. 자동화가 그것을 적용합니다. 분석은 이력에서 변경 빈도와 실패를 읽습니다.
모범 사례
- 모든 변경을 코드에 둡니다. 저장소를 중요한 시스템의 변경 경로로 삼고, 정의된 비상 상황이 아니면 수동 변경을 금지하세요. 비상 변경을 기록하고 코드로 되돌려 반영하세요.
- 검토와 작은 변경을 씁니다. 모든 변경에 두 번째 사람의 검토를 요구하고, 이해할 수 있을 만큼 작게 유지하세요. 무엇이 바뀔지 미리 보기를 보여 주세요.
- 선언형 정의와 멱등적 단계를 선호합니다. 반복하고 드리프트를 점검하기 더 쉽습니다. 필요한 작업에는 명령형 스크립트를 조심해서 쓰세요.
- 드리프트를 탐지하고 바로잡습니다. 일정에 따라 또는 지속적으로 실제 상태를 원하는 상태와 비교하세요. 드리프트의 종류마다 자동으로 되돌릴지 알림만 보낼지 정하세요.
- 비밀을 코드 밖에 둡니다. 비밀 관리자를 쓰고, 필요하면 암호화하고, 자동화에 짧은 수명의 자격 증명을 주고, 저장소에서 유출된 비밀을 스캔하세요.
- 상태와 저장소를 보호합니다. 누가 운영 정의와 상태를 바꿀 수 있는지 제한하고, 브랜치 보호를 강제하고, 저장소와 상태를 백업하세요.
- 적용 전에 시험합니다. 정책 점검, 미리 보기, 일회용 환경에서의 시험을 돌리세요. 예기치 않은 삭제가 있는지 계획을 검토하세요.
- 피해 반경을 제한합니다. 정의를 독립적으로 실패할 수 있는 단위로 나누고, 단계적으로 롤아웃하고, 중요한 리소스를 실수로 인한 삭제로부터 보호하세요.
- 오너가 있는 시험된 모듈을 재사용합니다. 표준 패턴을 위한 버전이 있는 모듈을 문서와 릴리스 노트와 함께 게시하고 오래된 버전을 폐기하세요.
- 복구를 계획합니다. 데이터 복원을 포함해 코드로 환경을 다시 만드는 일을 연습하고 시간을 재세요. 저장소와 도구를 연속성 계획에 포함하세요. 주제 3.12 — 서비스 연속성 관리를 참조하세요.
팀과 논의할 질문
우리의 시스템 중 오늘 코드로 다시 만들 수 있는 것은 무엇이며, 기억으로만 가능한 것은 무엇입니까? 목록을 만드세요. 한 사람에게 의존하는 것이 많을 것으로 예상됩니다. 더 깊이 들어가려면, 시스템 하나를 골라 코드로 정의하세요.
누군가 마지막으로 운영 환경을 손으로 바꾼 것은 언제이며, 어떻게 알았습니까? 이야기를 요청하세요. 아무도 추적하지 않을 것으로 예상됩니다. 더 깊이 들어가려면, 환경 하나에 드리프트 탐지를 더하고 차이가 있을 때 어떻게 할지 합의하세요.
비밀이 저장소나 상태 파일에 있을 수 있는 곳은 어디입니까? 함께 검색해 보세요. 놀라움이 예상됩니다. 더 깊이 들어가려면, 저장소를 스캔하고 발견한 것을 비밀 관리자로 옮기세요.
한 번의 적용이 할 수 있는 가장 큰 변경은 무엇이며, 어떻게 제한합니까? 공유 모듈과 단일체 상태를 생각해 보세요. 불편한 답이 예상됩니다. 더 깊이 들어가려면, 큰 상태 하나를 더 작은 것들로 나누세요.
인프라 변경을 어떻게 검토하며, 검토자는 실제로 무엇을 봅니까? 최근 검토 하나를 요청하세요. 빠른 승인이 예상됩니다. 더 깊이 들어가려면, 계획 출력과 보안 영향 같은 검토자가 점검해야 할 것에 합의하세요.
AI가 인프라 코드를 쓰거나 검토하는 데 어떻게 도울 수 있으며, 어떻게 확인합니까? AI는 정의의 초안을 쓰고 계획을 설명할 수 있습니다. 안전하지 않은 기본값이나 잘못된 리소스 설정을 낼 수도 있습니다. 누가 검토하고 어떤 점검이 돌아가는지 물으세요. 더 깊이 들어가려면, AI가 초안을 쓴 코드를 다른 코드와 같은 정책 점검에 통과시키세요.
실제 적용: 서비스 관리 사례
한 국립 도서관의 디지털 팀은 퍼블릭 클라우드에서 카탈로그 검색 서비스를 운영합니다. 환경은 여러 해에 걸쳐 손으로 만들어졌습니다. 시험 환경은 아무도 나열할 수 없는 점에서 운영 환경과 다르고, 최근의 장애는 이전 인시던트 중에 수동으로 한, 기록되지 않은 보안 그룹 변경에서 비롯된 것으로 추적되었습니다.
플랫폼 리드는 시범 사업으로 환경 하나를 코드로 정의하기로 합니다. 팀은 선언형 도구로 시험 환경의 네트워크, 컴퓨팅, 데이터베이스, 접근 규칙을 기술하고, 기존 리소스를 가져오고, 코드를 브랜치 보호와 필수 검토가 있는 저장소에 둡니다. 파이프라인은 공개 스토리지 금지와 필수 태그 같은 정책 점검을 실행하고 풀 리퀘스트마다 계획을 보여 줍니다. 비밀은 클라우드 제공자의 비밀 관리자로 옮겨 갑니다.
그다음 드리프트 탐지를 더합니다. 야간 작업이 코드를 클라우드의 실제 상태와 비교해 차이를 팀 채널에 게시합니다. 첫 주에 수동 변경 열한 개를 찾습니다. 여덟 개는 무해하고, 둘은 오래된 시험 리소스이며, 하나는 데이터베이스 포트에 열려 있는 방화벽 규칙입니다. 규칙을 고치고 리소스를 삭제합니다.
석 달 뒤 운영 환경도 코드로 옮겨졌고, 컨테이너 플랫폼의 GitOps 방식 컨트롤러가 저장소에서 승인된 변경을 적용합니다. 시험 환경을 처음부터 다시 만드는 데 40분이 걸립니다. 팀은 별도의 계정에서 데이터 복원을 포함해 운영 환경을 다시 만드는 일을 반나절 안에 연습합니다.
달라진 점은 변경 이력이 저장소에 있고, 검토가 실질적이며, 두 환경이 일치한다는 것입니다. 여전히 어려운 점은 오래된 데이터베이스 서버가 도구의 지원이 부족해 일부 수동으로 남아 있다는 것, 상태 파일에 이전 가져오기에서 온 평문 비밀번호가 있어 팀이 교체해야 했다는 것, 한 엔지니어가 다른 도구 버전의 노트북에서 변경을 적용해 예기치 않은 차이가 생겼다는 것입니다. 리드는 파이프라인에 고정된 도구 버전, 적용은 파이프라인에서만 한다는 규칙, 상태에서 비밀을 찾는 스캔을 더합니다.
네 가지 관점
제품 및 전달 팀
서비스의 인프라를 애플리케이션 옆에서 코드로 정의하고, 검토하고, 일회용 환경에서 시험하세요. 수동 변경을 피하세요. 정의에 태그, 오너십, 보안 설정을 포함하세요.
서비스 및 운영 팀
저장소를 변경의 기록으로 쓰고 드리프트를 탐지하세요. 계획을 주의 깊게 검토하고, 상태와 비밀을 보호하고, 다시 만들기를 연습하세요. 비상 변경은 드물게 하고 코드로 되돌려 반영하세요.
리더십과 거버넌스
회의 대신 저장소와 파이프라인의 증거를 요청하세요. 도구, 교육, 연습에 재원을 대세요. 수동 운영 변경은 기록해야 하는 예외임을 분명히 하세요.
고객과 사용자
같은 방식으로 동작하는 환경과 더 빠른 복구의 혜택을 봅니다. 변경 뒤에 놀라움이 줄고, 중대한 변경에 대한 분명한 통지를 보아야 합니다.
애자일, AI, 자동화, 분석
애자일
빠른 피드백이 있는 작고, 검토되고, 되돌릴 수 있는 인프라 변경은 지속적 전달의 운영적 형태입니다. 가장 고통스러운 환경부터 정의를 점진적으로 만드세요. 주의: 모든 시스템을 한꺼번에 코드로 대량 이전하는 것은 위험하므로, 하나씩 옮기세요.
AI
AI는 정의의 초안을 쓰고, 계획을 설명하고, 정책 규칙을 제안할 수 있으며, 사람이 모든 변경을 검토합니다. 각 사용에 오너를 지정하세요. 주의: 생성된 인프라 코드는 기본으로 안전하지 않거나 리소스를 삭제할 수 있으므로, 같은 정책 점검을 적용하고 계획을 읽으세요. 주제 5.4 — 인시던트, 지식, 변경을 위한 생성형 AI를 참조하세요.
자동화
IaC와 GitOps는 인프라 자체의 자동화입니다. 컨트롤러와 파이프라인은 모든 것을 바꿀 수 있으므로, 최소 권한으로 두고, 기록하고, 보호하세요. 주의: 자동 조정기는 실수를 모든 곳에 다시 적용할 수 있으므로, 롤아웃을 단계화하고 멈출 방법을 유지하세요. 주제 6.4 — 파이프라인과 자동화된 변경을 참조하세요.
분석
변경 빈도, 실패율, 다시 만드는 시간, 드리프트 수, 수동 변경 탐지 시간, 정책 위반을 보세요. 주의: 커밋 수를 세면 활동에 보상이 가고, 낮은 드리프트 수는 약한 탐지기를 반영할 수 있으므로, 알려진 변경으로 탐지를 시험하세요. 서비스 관리 지표(Service Management Metrics) 책과 주제 7.3 — 측정과 보고를 참조하세요.
흔한 실패 유형
- 혼합된 현실. 일부 변경은 코드로, 일부는 손으로 합니다. 드리프트가 커집니다. 코드를 유일한 경로로 삼고 드리프트를 탐지하세요.
- 저장소 속 비밀. 자격 증명이 유출됩니다. 비밀 관리자를 쓰고 스캔하세요.
- 거대한 공유 상태. 한 변경이 모든 것에 영향을 줍니다. 더 작은 단위로 나누세요.
- 검토되지 않은 변경. 실수가 운영 환경에 닿습니다. 검토를 요구하고 계획을 보여 주세요.
- 고정되지 않은 도구와 모듈. 행동이 예기치 않게 바뀝니다. 버전을 고정하세요.
- 한 번도 다시 만들지 않음. 필요할 때 복구가 실패합니다. 다시 만들기를 연습하세요.
- 슈퍼유저로서의 파이프라인. 침해된 파이프라인이 운영 환경을 장악합니다. 권한을 제한하고 보호하세요.
성숙도 모델
| 영역 | 시작 | 발전 | 표준화 | 관리 | 오케스트레이션 |
|---|---|---|---|---|---|
| 범위 | 수동 | 일부 리소스를 코드로 | 가장 중요한 시스템을 코드로 정의 | 범위와 예외를 추적한다 | 전체 자산을 코드로 정의하고 거버넌스한다 |
| 통제 | 검토 없음 | 동료 검토 | 모든 변경에 검토, 계획 미리 보기, 정책 점검 | 드리프트를 탐지하고 대응한다 | 환경 전반에서 사람의 감독 아래 조정한다 |
| 보안 | 코드 속 비밀 | 인식한다 | 비밀을 관리하고 스캔하며 최소 권한 자동화 | 발견 사항을 해결까지 추적한다 | 공유 모듈에 보안과 정책이 내장된다 |
| 복구 | 기억으로 다시 만든다 | 문서화되어 있다 | 다시 만들기를 연습하고 시간을 잰다 | 복구 시간을 측정하고 개선한다 | 환경과 리전 전반에서 복구를 자동화한다 |
체크리스트
- 중요한 시스템이 버전 관리 속 코드로 정의되어 있다.
- 모든 변경이 검토되고 계획 미리 보기를 보여 준다.
- 기록된 비상 상황을 제외하고 수동 운영 변경이 금지되어 있다.
- 드리프트를 일정에 따라 탐지하고 규칙으로 처리한다.
- 비밀이 관리자에 있고 저장소와 상태를 스캔한다.
- 도구와 모듈이 고정되어 있고 오너가 있다.
- 피해 반경을 제한하도록 정의가 나뉘어 있다.
- 환경을 다시 만드는 일을 연습하고 시간을 기록한다.
AI 프롬프트
계획 출력을 검토합니다.
Here is the plan output from an infrastructure change: [paste].
List resources to be created, changed, and destroyed, highlight any deletion or replacement of a data store or network component, and list questions a reviewer should ask. Do not approve or reject.
List what you are unsure of.
요구 사항에서 정책 규칙의 초안을 작성합니다.
Our requirements: [list, such as no public storage, tags required, encryption at rest]. Our tool: [name, or "undecided"].
Write each requirement as a plain-language rule with one example of a violation, and describe how to test the rule. Do not write code unless I name the tool.
List what you are unsure of.
드리프트 발견 사항을 요약합니다.
Here is a drift report listing differences between code and the running environment: [paste].
Group the differences by type (extra resource, changed setting, missing resource), flag any that touch access, network, or encryption, and write one question per group for the team. Do not recommend fixes.
List what you are unsure of.
AI 스킬
- configuration-management: 코드 정의를 그것이 지원하는 서비스에 연결할 때 사용합니다.
- change-request: 검토를 위해 인프라 변경을 분명하게 설명할 때 사용합니다.
- security-testing: 인프라 코드와 비밀에 대한 점검을 계획할 때 사용합니다.
- disaster-recovery-testing: 코드로 다시 만드는 일을 연습할 때 사용합니다.
- runbook: 남아 있는 비상 수동 절차를 문서화할 때 사용합니다.
주요 출처
- Kief Morris, Infrastructure as Code (2nd edition, 2020): 인프라를 정의하고 관리하는 실용적인 안내서.
- Jez Humble and David Farley, Continuous Delivery (2010): 반복 가능한 환경과 파이프라인의 기초.
- The documentation of the tools you use, such as Terraform, Ansible, and Kubernetes: 도구의 동작에 대한 권위 있는 출처.
- Wikipedia, "Infrastructure as code": 접근의 개관.
참고 문헌
- Infrastructure as code — Wikipedia — https://en.wikipedia.org/wiki/Infrastructure_as_code
- DevOps — Wikipedia — https://en.wikipedia.org/wiki/DevOps
- Declarative programming — Wikipedia — https://en.wikipedia.org/wiki/Declarative_programming
- Imperative programming — Wikipedia — https://en.wikipedia.org/wiki/Imperative_programming
- Idempotence — Wikipedia — https://en.wikipedia.org/wiki/Idempotence
- Git — Wikipedia — https://en.wikipedia.org/wiki/Git
- Version control — Wikipedia — https://en.wikipedia.org/wiki/Version_control
- Code review — Wikipedia — https://en.wikipedia.org/wiki/Code_review
- Containerization (computing) — Wikipedia — https://en.wikipedia.org/wiki/Containerization_(computing)
- Control theory — Wikipedia — https://en.wikipedia.org/wiki/Control_theory
- Kubernetes — Wikipedia — https://en.wikipedia.org/wiki/Kubernetes
- Terraform (software) — Wikipedia — https://en.wikipedia.org/wiki/Terraform_(software)