오늘의 기술 토픽
Infrastructure as Code with Crossplane
Crossplane은 Kubernetes API를 확장해 클라우드 리소스를 쿠버네티스 오브젝트처럼 선언적으로 관리할 수 있게 해주는 오픈소스 프로젝트다. 기존 Terraform 중심의 IaC 워크플로우와 달리, 상태 관리와 리소스 프로비저닝을 쿠버네티스 컨트롤러 패턴으로 통합한다는 점이 특징이다. 이 브리핑은 Crossplane이 어떤 문제를 풀기 위해 등장했는지, 그리고 GitOps·플랫폼 엔지니어링 흐름과 어떻게 맞물리는지를 정리한다. 관련 기술로 Terraform, Argo CD, 쿠버네티스 Operator 패턴을 함께 다룬다.
🔑 핵심 요점
- Crossplane은 클라우드 리소스(DB, VPC, 버킷 등)를 쿠버네티스 커스텀 리소스(CRD)로 선언하고 관리하게 해준다.
- Terraform이 별도의 state 파일과 CLI 실행에 의존하는 반면, Crossplane은 쿠버네티스 컨트롤러가 지속적으로 원하는 상태(desired state)를 수렴시킨다.
- Composition 기능을 통해 여러 저수준 리소스를 묶어 하나의 ‘플랫폼 API’로 추상화할 수 있다.
- Argo CD 같은 GitOps 도구와 결합하면 애플리케이션과 인프라를 동일한 Git 기반 워크플로우로 관리할 수 있다.
- 이런 접근은 플랫폼 엔지니어링(Internal Developer Platform) 트렌드, 즉 개발자에게 self-service 인프라를 제공하려는 흐름과 맞닿아 있다.
🛠 핵심 기술 쉽게 이해하기
Crossplane
Crossplane은 쿠버네티스 API를 확장해 AWS, GCP, Azure 같은 클라우드 제공자의 리소스를 쿠버네티스 커스텀 리소스(CRD)로 정의하고 관리할 수 있게 해주는 오픈소스 프레임워크다. Provider라는 플러그인을 통해 실제 클라우드 API와 통신하며, 쿠버네티스 컨트롤러 패턴으로 리소스 상태를 지속적으로 맞춰준다.
왜 필요한가 — 클라우드 인프라 관리를 애플리케이션 배포와 동일한 쿠버네티스 선언적 방식으로 통합하고, 플랫폼 팀이 자체 API를 만들어 개발자에게 제공할 수 있게 하기 위해 사용한다.
발표에서는 — 이번 브리핑의 중심 주제로, 쿠버네티스 네이티브 방식의 IaC가 어떻게 동작하는지 기본 개념 위주로 다룬다.
Terraform
Terraform은 HCL이라는 선언적 언어로 인프라를 코드로 작성하고, plan/apply 사이클을 통해 클라우드 리소스를 생성·변경·삭제하는 대표적인 IaC 도구다.
왜 필요한가 — 수동으로 콘솔에서 리소스를 만드는 대신 코드로 재현 가능하고 버전 관리 가능한 인프라를 구성하기 위해 쓰인다.
발표에서는 — Crossplane과 비교 대상으로 언급되며, CLI 기반 실행 모델과 쿠버네티스 컨트롤러 기반 모델의 차이를 설명하는 데 활용된다.
Argo CD
Argo CD는 Git 리포지토리에 선언된 상태를 쿠버네티스 클러스터에 자동으로 동기화하는 GitOps 전용 CD 도구다.
왜 필요한가 — 배포 이력을 Git으로 추적하고, 클러스터의 실제 상태와 원하는 상태의 드리프트를 자동으로 감지·교정하기 위해 사용한다.
발표에서는 — Crossplane으로 정의한 인프라 리소스를 Git 기반으로 함께 관리하는 조합 사례로 언급된다.
Kubernetes Operator Pattern
Operator 패턴은 쿠버네티스 커스텀 컨트롤러가 특정 도메인의 리소스를 지속적으로 감시하며 원하는 상태로 수렴시키는 설계 방식이다.
왜 필요한가 — 애플리케이션이나 인프라의 운영 지식을 코드로 자동화해 사람의 수동 개입을 줄이기 위해 쓰인다.
발표에서는 — Crossplane이 내부적으로 의존하는 기반 원리로, 왜 Crossplane 리소스가 ‘선언 후 자동 수렴’하는지를 설명하는 맥락에서 다뤄진다.
🧭 추구 방향과 흐름
- 플랫폼 엔지니어링(Internal Developer Platform) — Crossplane의 Composition 기능은 저수준 클라우드 리소스를 조합해 팀 내부용 ‘플랫폼 API’를 만드는 데 초점을 둔다. 이는 개발자가 인프라 세부사항을 몰라도 self-service로 필요한 리소스를 받을 수 있게 하려는 플랫폼 엔지니어링 트렌드와 일치한다.
- GitOps로의 통합 — 인프라 정의를 쿠버네티스 매니페스트 형태로 관리할 수 있게 되면서, Argo CD 같은 GitOps 도구와 자연스럽게 결합할 수 있다. 애플리케이션과 인프라를 하나의 Git 기반 파이프라인으로 다루는 방향으로 이어진다.
- 선언적 상태 수렴 모델 확산 — Terraform의 명령형 실행(plan/apply) 방식과 달리, Crossplane은 쿠버네티스 컨트롤러 루프를 통해 지속적으로 상태를 맞춘다. 이런 ‘컨트롤 루프’ 방식이 인프라 관리 전반으로 확산되는 흐름이 나타난다.
🚀 바로 활용하기
- 로컬 환경(kind 또는 minikube)에 쿠버네티스 클러스터를 띄우고 Helm으로 Crossplane을 설치해본다.
- 원하는 클라우드용 Provider(예: provider-aws, provider-gcp)를 설치하고 간단한 리소스(S3 버킷 등) 하나를 CRD로 선언해 생성해본다.
- Composition 예제를 따라 여러 리소스를 묶어 하나의 커스텀 API로 추상화해본다.
- Argo CD 공식 문서를 참고해 Crossplane 리소스를 Git 리포지토리 기반으로 동기화하는 흐름을 구성해본다.
🔗 참고 자료
- Crossplane 공식 홈페이지 — Crossplane의 핵심 개념(Provider, Composition 등)과 설치 가이드를 확인할 수 있다.
- Kubernetes 공식 문서 — CRD와 컨트롤러 패턴 등 Crossplane이 기반하는 쿠버네티스 개념을 이해하는 데 필요하다.
- Terraform 공식 홈페이지 — Crossplane과 비교되는 전통적 IaC 도구의 동작 방식을 확인할 수 있다.
- Argo CD 공식 문서 — Crossplane 리소스를 GitOps 방식으로 동기화하는 방법을 다룬다.
- CNCF — Crossplane과 Argo CD를 포함한 클라우드 네이티브 프로젝트들의 생태계와 트렌드를 확인할 수 있다.