쿠버네티스 KinD(Kubernetes in Docker)는 로컬 환경에서 쿠버네티스를 가장 가볍고 효율적으로 실행할 수 있게 해주는 도구이며, KinD는 단순히 쿠버네티스를 띄우는 프로그램을 넘어, 도커(Docker) 인프라를 활용하여 실제 클러스터와 유사한 환경을 재현합니다.
1. KinD CLI (The Orchestrator)
KinD의 가장 바깥층에 있는 커맨드 라인 인터페이스(CLI)입니다. 사용자가 터미널에서 입력하는 명령어를 받아 클러스터를 생성, 삭제 및 관리하는 역할을 합니다.
- 주요 기능: 클러스터 생성(
create cluster), 삭제(delete cluster), 로컬 이미지 주입(load docker-image) 등을 수행합니다.
2. Docker Containers (The Nodes)
KinD 아키텍처의 가장 큰 특징은 도커 컨테이너 자체가 쿠버네티스의 노드(Node)가 된다는 점입니다. 기존 미니큐브가 VM을 사용했던 것과 달리, KinD는 컨테이너 기술을 사용하여 자원 소모를 최소화합니다.
- 특징: 각 컨테이너 내부에는 쿠버네티스 구동에 필요한
kubelet,containerd,kubeadm등이 미리 설치되어 있습니다.
3. Cluster Configuration (The Blueprint)
kind-config.yaml 파일은 클러스터의 설계도 역할을 합니다. 이 파일을 통해 클러스터가 몇 개의 노드를 가질지, 어떤 포트를 호스트와 연결할지 정의합니다.
- 핵심 설정:
nodes(역할 정의),extraPortMappings(포트 매핑),extraMounts(로컬 디렉토리 연결) 등이 포함됩니다.
4. Control Plane & Worker Nodes (The Roles)
KinD는 컨테이너별로 역할을 부여하여 실제 운영 환경과 유사한 멀티 노드 환경을 구성합니다.
- Control Plane Node: API 서버, etcd, 스케줄러 등이 실행되는 클러스터의 ‘뇌’입니다.
- Worker Node: 실제 사용자의 애플리케이션(Pod)이 배포되어 실행되는 ‘몸통’입니다.
5. Local Image Loader (The Bridge)
로컬에서 빌드한 이미지를 외부 저장소(Docker Hub 등)를 거치지 않고 클러스터 내부로 직접 전달하는 브릿지 기능입니다.
- 작동 원리:
kind load docker-image명령어를 사용하면 호스트 시스템의 이미지를 각 노드 컨테이너의 내부 저장소로 복사하여 즉시 사용할 수 있게 합니다.
💡 요약: 왜 KinD를 구성 요소별로 알아야 하나요?
| 구성 요소 | 역할 | 블로그 작성 포인트 |
|---|---|---|
| KinD CLI | 사용자 명령 처리 | “간편한 클러스터 제어” |
| Docker Nodes | 물리적 실행 환경 | “가벼운 컨테이너 기반 가상화” |
| Config YAML | 클러스터 정의 | “코드형 인프라(IaC)의 시작” |
| Node Roles | 작업 분담 | “실전 같은 멀티 노드 테스트” |
| Image Loader | 데이터 전달 | “빠른 개발 피드백 루프” |
Note: KinD는 특히 CI(지속적 통합) 환경이나 로컬에서 멀티 노드 스케줄링을 테스트할 때 그 진가를 발휘합니다.