Nomad CSI 볼륨 명세

Nomad CSI 볼륨 명세 (Nomad Container Storage Interface (CSI) volume specification)

Container Storage Interface(CSI) 볼륨의 명세 — CSI 플러그인이 제공하는 외부 스토리지를 작업에 연결하는 방법을 알아봐요.

출처: 문서

본문

CSI(Container Storage Interface) 볼륨은 CSI 호환 스토리지 플러그인을 통해 프로비저닝된 볼륨이에요. Nomad 클라이언트에서 실행되는 CSI 플러그인은 외부 스토리지 시스템과 통신해 볼륨을 생성·삭제·연결·마운트해요.

CSI 볼륨 정의

CSI 볼륨은 작업 명세 안의 volume 스탠자(또는 nomad volume create CLI)로 정의되며, type = "csi"를 지정해요.

job "example" {
  group "example" {
    volume "db" {
      type      = "csi"
      source    = "my-csi-volume"
      read_only = false

      capability {
        access_mode     = "single-node-writer"
        attachment_mode = "file-system"
      }
    }
  }
}

CSI 볼륨 파라미터

파라미터	설명
`type`	`csi`로 설정해야 해요.
`source`	사용할 CSI 볼륨의 이름(또는 ID).
`read_only`	볼륨을 읽기 전용으로 마운트할지 여부. 기본값은 `false`.
`attachment_mode`	(선택) 볼륨 연결 방식을 지정.
`access_mode`	(선택) 볼륨 접근 방식을 지정.
`mount_options`	(선택) 마운트 옵션.
`topology_request`	(선택) 볼륨 배치 위치 제한.
`per_alloc`	(선택) 할당별 볼륨 마운트.
`staging`	(선택) 스테이징 경로.

CSI 플러그인 상태

CSI 플러그인은 Nomad에서 csi_plugin 스탠자로 등록된 태스크 드라이버에 의해 실행돼요. 플러그인은 컨트롤러 및/또는 노드 역할을 담당하며, 클러스터에 등록된 후 nomad plugin status 명령으로 상태를 확인할 수 있어요.

CSI 볼륨을 사용하려면 먼저 볼륨이 등록되어 있어야 해요. nomad volume create 또는 nomad volume register 명령으로 등록할 수 있어요.

Nomad CSI 볼륨 명세