CephRBD CSI (블록 스토리지)

쿠버네티스 클러스터 노드에 Ceph RBD 블록 볼륨을 동적으로 프로비저닝하고 마운트하는 기능입니다.

사전 준비

스토리지 설치(Ceph 클러스터)가 먼저 끝나 있어야 합니다.

사전 준비 — 설정 변수 확인

플레이북 실행 전에 inventory/qks/group_vars/all/all-ceph.yaml의 CSI 블록 값을 확인합니다. 기본값 그대로도 동작하지만, 바꿔야 하는 상황이면 미리 여기서 조정합니다.

StorageClass 이름을 바꾸는 경우 all-k8s.yaml의 kube_default_storage_class_name도 같이 맞춰야 기본 StorageClass로 지정됩니다. kube_version을 올렸는데 compatible-matrix.yaml에 해당 키가 없으면 플레이북이 그 자리에서 에러로 종료되니, 새 버전을 미리 매트릭스에 추가해야 합니다.

플레이북 실행

./install.sh ubuntu plays/qks-csi-cephrbd.yaml

설치 흐름

1. OS 준비           rbd 커널모듈 로드(전 노드), ceph-common 설치(클라이언트 노드)
2. 클러스터 정보 조회  admin 노드에서 fsid/모니터 주소/관리자 키를 실시간 조회
3. Helm 차트 배포     ceph-csi-rbd 차트 설치
4. K8s 리소스 생성    Secret, StorageClass(qks-ceph-block) 생성
5. 기본 StorageClass 지정

설치 내용

• StorageClass qks-ceph-block (이 환경에서 기본값으로 지정됨)
• qks-ceph 네임스페이스에 qks-cephrbd-ceph-csi-rbd-nodeplugin(DaemonSet, 노드마다 1개), qks-cephrbd-ceph-csi-rbd-provisioner(Deployment, 여러 개 복제) 파드

설치 확인

드라이버 파드 상태와 StorageClass 등록 여부를 먼저 확인합니다.

kubectl get pods -n qks-ceph | grep cephrbd
kubectl get storageclass qks-ceph-block

실제 PVC 생성 + 파드 마운트 테스트

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: test-rbd-pvc
spec:
  accessModes: ["ReadWriteOnce"]
  storageClassName: qks-ceph-block
  resources:
    requests:
      storage: 1Gi
---
apiVersion: v1
kind: Pod
metadata:
  name: test-rbd-pod
spec:
  containers:
  - name: busybox
    image: busybox
    command: ["sh", "-c", "echo hello-rbd > /mnt/test.txt && sleep 3600"]
    volumeMounts:
    - {name: data, mountPath: /mnt}
  volumes:
  - name: data
    persistentVolumeClaim: {claimName: test-rbd-pvc}

kubectl get pvc test-rbd-pvc      # STATUS: Bound 이어야 함
kubectl get pod test-rbd-pod      # READY: 1/1, STATUS: Running 이어야 함
kubectl exec test-rbd-pod -- cat /mnt/test.txt   # hello-rbd 출력되어야 함

확인 후 정리:

kubectl delete pod test-rbd-pod
kubectl delete pvc test-rbd-pvc

PVC가 Bound되면 Provisioner가 Ceph에 실제 RBD 이미지를 만든 것이고, Pod가 Running 상태로 파일을 정상 읽고 쓰면 Node Plugin이 그 볼륨을 컨테이너에 실제로 마운트한 것입니다. 커널 버전 요구사항을 충족하지 못한 노드에 파드가 스케줄되면 이 단계(마운트 시점)에서 실패합니다.

다음 단계