CNI 네트워크 설치

Cilium, Calico, Flannel, Multus 등 컨테이너 간 통신을 위한 CNI 네트워크를 설치합니다.

QUANTUM C&S

Cilium, Calico, Flannel, Multus 등 컨테이너 간 통신을 위한 CNI 네트워크를 설치합니다.

신규 클러스터 설치 시에는 K8s 클러스터 초기화, 워커 노드 조인, 컨테이너 런타임 설치와 함께 k8s.yaml 실행 안에서 자동으로 처리됩니다. CNI 설정만 다시 적용하고 싶을 때는 아래처럼 plays/qks-cni.yaml만 따로 실행할 수도 있습니다.

검증 현황: Cilium(기본값)만 실제 서버에 설치해 검증했습니다. Calico/Flannel/Multus 옵션은 코드상 지원되는 것은 확인했으나(roles/qks-kubernetes/cni/* 존재), 아직 실제로 설치 · 검증하지 않았습니다.

설정값

kube_cni: "cilium"          # cilium(기본) / calico / flannel
cni_cilium_version: "1.19.4"
# kube_cni_multus_enabled: true   # 선택한 CNI 위에 Multus(파드에 여러 네트워크 인터페이스 부착)를 추가 설치

Cilium (기본)

eBPF 기반 CNI. Helm 차트로 설치됩니다. 검증 완료.

Calico / Flannel

kube_cni를 calico 또는 flannel로 지정. 둘 다 매니페스트로 설치됩니다. 미검증.

Multus (선택)

kube_cni_multus_enabled: true로 선택한 CNI 위에 추가 설치. 미검증.

플레이북 실행

신규 설치(다른 3개 항목과 함께):

./install.sh ubuntu k8s.yaml

CNI만 다시 적용:

./install.sh ubuntu plays/qks-cni.yaml

설치 흐름 (이 항목에 해당하는 부분)

5. 컨트롤플레인 초기화   (qks-kubernetes/k8s/master)
6. CNI 설치              (qks-kubernetes/cni) ← 이 항목
7. Worker 노드 조인      (qks-kubernetes/k8s/worker)

컨트롤플레인이 초기화된 뒤(5단계), 워커가 조인되기 전(7단계)에 CNI가 먼저 설치되어야 파드 네트워킹이 정상 동작합니다.

설치 확인

kubectl get pods -n kube-system

선택한 CNI(cilium/calico/flannel) 파드가 Running인지 확인합니다.

helm list -A

Cilium은 Helm으로 설치되므로 릴리즈가 deployed 상태인지 확인합니다.

kube_cni_multus_enabled: true인 경우 같은 네임스페이스에서 multus 파드도 Running인지 확인합니다.

다음 단계

💾 스토리지 설치 Ceph 클러스터 구성하기 ✅ 설치 후 확인 클러스터 접근 및 상태 확인

이전 문서

← 컨테이너 런타임 설치

다음 문서

스토리지 설치 (Ceph) →