Nomad 동적 호스트 볼륨 명세

Nomad 동적 호스트 볼륨 명세 (Nomad dynamic host volume specification)

Nomad가 동적으로 생성·관리하는 호스트 볼륨의 명세를 알아봐요.

출처: 문서

본문

호스트 볼륨(host volume)은 Nomad 클라이언트의 로컬 파일 시스템 디렉토리를 작업에 노출시키는 볼륨이에요. "동적 호스트 볼륨"은 Nomad가 볼륨의 수명을 관리하며, nomad volume create CLI 명령으로 생성·삭제되는 호스트 볼륨을 말해요.

동적 호스트 볼륨

동적 호스트 볼륨은 다음 특성을 가져요.

  • Nomad 클라이언트의 파일 시스템을 사용
  • type = "host"로 정의
  • nomad volume create 명령으로 생성
  • ACL 권한과 쿼터로 제어
  • 볼륨 생성 시 스토리지 클래스와 크기, 위치 등을 지정

nomad volume create 명령으로 동적 호스트 볼륨을 생성할 때는 볼륨 스펙이 담긴 파일을 지정해요. 스펙은 볼륨 이름, 스토리지 클래스(node_class 또는 storage 클래스), 크기, 노드 풀/위치 등을 포함해요.

호스트 볼륨 예시 파일

type   = "host"
name   = "my-host-volume"
storage_class = "fast"
size_min = 10240

# optional location constraints
node_pool = "linux"

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

nomad volume create 명령 예시:

$ nomad volume create volume.hcl

작업에서 호스트 볼륨 사용

작업 명세에서 type = "host" 볼륨 스탠자를 사용해 호스트 볼륨을 마운트할 수 있어요.

job "example" {
  group "group" {
    volume "data" {
      type   = "host"
      source = "my-host-volume"
    }
  }
}

호스트 볼륨 파라미터

파라미터 설명
type host로 설정해야 해요.
read_only 읽기 전용 마운트 여부.
source 사용할 호스트 볼륨의 이름.
per_alloc 할당별 볼륨 할당 여부.

더 알아보기 (Learn more)