본문 바로가기
문서 목차
ORKESTRIX설치

워커 노드 조인 · 추가

신규 컴퓨팅 워커 노드를 쿠버네티스 클러스터에 동적으로 참여시키고 확장합니다.

QUANTUM C&S

신규 컴퓨팅 워커 노드를 쿠버네티스 클러스터에 동적으로 참여시키고 확장합니다.

이 항목은 K8s 클러스터 초기화, 컨테이너 런타임 설치, CNI 네트워크 설치와 함께 하나의 플레이북(k8s.yaml) 실행 안에서 순서대로 처리됩니다. 실행 명령은 K8s 클러스터 초기화와 동일합니다.

사전 준비

K8s 클러스터 초기화가 먼저 끝나 있어야 합니다(컨트롤플레인이 Ready 상태). 워커로 조인시킬 노드는 inventory/qks/hosts.ubuntu의 kube-worker(또는 qks-worker) 그룹에 포함되어 있어야 합니다.

플레이북 실행

./install.sh ubuntu k8s.yaml

기존 클러스터에 워커를 나중에 추가하는 경우, 인벤토리에 새 워커 노드를 추가한 뒤 같은 명령을 다시 실행하면 됩니다 — 이미 조인된 노드는 자동으로 건너뜁니다.

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

5. 컨트롤플레인 초기화     (qks-kubernetes/k8s/master)
6. CNI 설치                (qks-kubernetes/cni)
7. Worker 노드 조인        (qks-kubernetes/k8s/worker) ← 이 항목
   - kubeadm join 실행 (로드밸런서 경유로 컨트롤플레인에 접속)
8. 노드 라벨/Taint 설정

CNI(6단계)가 먼저 설치되어 있어야 워커가 조인된 뒤 정상적으로 파드 네트워킹에 합류합니다.

설치 확인

kubectl get nodes -o wide

워커 노드가 worker(또는 빈 <none>) 롤로 전부 Ready 상태여야 합니다.

NAME          STATUS   ROLES           AGE   VERSION
master-01     Ready    control-plane   5m    v1.x.x
worker-01     Ready    <none>          4m    v1.x.x
worker-02     Ready    <none>          4m    v1.x.x

다음 단계