minikube용 Calico 퀵스타트

원문 보기 위키 갱신 2026.10.11

minikube 클러스터에 Calico를 설치하는 세 가지 방법(내장, Operator, Manifest)을 소개하는 퀵스타트예요. 약 1분 만에 테스트·개발용 단일 노드 클러스터를 만들 수 있어요. 설치 확인, 워커 노드 추가, 정리 명령까지 함께 다뤄요.

출처: 문서

본문

큰 그림

이 퀵스타트로 약 1분 만에 Calico가 설치된 단일 노드 minikube 클러스터를 만들어요. 이 클러스터는 테스트와 개발에 사용할 수 있어요.

이런 점이 좋아요

이 퀵스타트를 사용하면 Calico 기능을 빠르고 쉽게 사용해 볼 수 있어요.

시작하기 전에

minikube를 설치하되 시작하지는 마세요. minikube 설치 방법
kubectl을 설치해요. kubectl 설치 방법
minikube 드라이버를 설치해요. 예를 들어 Docker예요. 사용 가능한 드라이버 전체 목록은 여기에서 찾을 수 있어요.

방법

단일 노드 minikube 클러스터 만들기

Tab: Built-in Calico

Minikube는 내장 Calico 구현을 제공해요. Calico 기능을 빠르게 둘러보기 좋은 방법이에요.

SECONDARY: 사전 설치된 Calico를 활성화하는 것이 테스트용으로는 가장 빠를 수 있어요. 하지만 더 최신 버전이나 Calico 기능을 확인하고 싶다면 Manifest 또는 Operator 방식을 고려하세요.

minikube start --cni=calico

Tab: Operator

다음 명령으로 컨트롤 플레인 노드 하나를 갖춘 minikube 클러스터를 시작해요.

SECONDARY: 네트워크에서 이미 192.168.0.0/16을 사용 중이라면 다음 명령에서 192.168.0.0/16을 다른 값으로 바꿔 다른 파드 네트워크 CIDR을 선택해야 해요.
```
minikube start --cni=false --network-plugin=cni --extra-config=kubeadm.pod-network-cidr=192.168.0.0/16 --subnet=172.16.0.0/24
```

Calico 커스텀 리소스 정의를 설치해요.

클러스터가 Kubernetes 1.36 이상 기반이라면:

kubectl create -f https://raw.githubusercontent.com/projectcalico/calico/v3.33.0/manifests/v3_projectcalico_org.yaml

클러스터가 Kubernetes 1.34 또는 1.35 기반이라면:

kubectl create -f https://raw.githubusercontent.com/projectcalico/calico/v3.33.0/manifests/v3_projectcalico_org-v1beta1.yaml

Tigera Operator를 설치해요.

kubectl create -f https://raw.githubusercontent.com/projectcalico/calico/v3.33.0/manifests/tigera-operator.yaml

필요한 커스텀 리소스를 만들어 Calico를 설치해요. 이 매니페스트에서 사용할 수 있는 구성 옵션에 대한 자세한 내용은 Tigera Operator API 레퍼런스를 참고하세요.

SECONDARY: 이 매니페스트를 만들기 전에 내용을 읽고 설정이 자신의 환경에 맞는지 확인하세요. 예를 들어 pod-network-cidr을 바꿨다면 이 파일에서도 바꿔야 해요.
```
kubectl create -f https://raw.githubusercontent.com/projectcalico/calico/v3.33.0/manifests/custom-resources.yaml
```

Tab: Manifest

다음 명령으로 컨트롤 플레인 노드 하나를 갖춘 minikube 클러스터를 시작해요.

minikube start --network-plugin=cni

Calico를 설치해요.

kubectl apply -f https://raw.githubusercontent.com/projectcalico/calico/v3.33.0/manifests/calico.yaml

Calico 설치 확인하기

다음 명령으로 클러스터에 Calico가 설치되었는지 확인해요.

watch kubectl get pods -l k8s-app=calico-node -A

아래와 비슷한 결과가 보일 거예요. 따라간 방법에 따라 네임스페이스가 다를 수 있다는 점에 유의하세요.

NAMESPACE     NAME                READY   STATUS    RESTARTS   AGE
kube-system   calico-node-mlqvs   1/1     Running   0          5m18s

ctrl+c로 watch에서 빠져 나오세요.

축하해요! 이제 Calico가 설치된 minikube 클러스터가 생겼어요.

워커 노드 추가하기

SECONDARY: 이 단계는 선택 사항이에요. 추가 워커 노드가 필요 없다면 안전하게 건너뛰어도 돼요.

minikube node add

다음 명령으로 노드를 확인해요.

kubectl get nodes

정리

다음 명령으로 클러스터를 삭제해요.

minikube delete

다음 단계

필요 사항

calicoctl 설치와 구성

권장 튜토리얼

더 알아보기 (Learn more)

빠르게 둘러보기엔 내장 Calico(--cni=calico)가 가장 간단해요. 최신 버전이나 오퍼레이터 기능을 검증하려면 Operator/Manifest 탭을 사용하세요. 설치 확인은 calico-node 파드가 Running인지 watch로 보는 것이 기본 진단 절차예요.