Nomad 1.10.x 릴리스 노트

Nomad 1.10.x 릴리스 노트 (Nomad 1.10.x Release Notes)

다음과 같은 Nomad 업데이트를 발표하게 되어 기쁘게 생각해요.

출처: 문서

본문

Nomad 버전 지원 (Nomad version support)

2026년 4월부터 HashiCorp의 자체 관리(self-managed) 제품은 새로운 버전·릴리스·지원 모델을 채택해요. Nomad는 계속해서 봄과 가을 기능 릴리스를 목표로 하며, 필요에 따라 월간 업데이트를 제공해요. 이러한 변경은 IBM의 기업 소프트웨어 수명주기와 일치하여 IBM 소프트웨어 포트폴리오 전반에 걸쳐 일관된 지원을 보장해요.

버전 기본 지원 종료 (Base Support End) 확장 지원 종료 (Extended Support End) 지속 확장 지원 종료 (Ongoing Extended Support End)
1.8.x (LTS) 2026년 4월 30일 2026년 4월 30일 2026년 4월 30일
1.10.x (LTS) 2027년 4월 30일 2027년 4월 30일 2027년 4월 30일
1.11.x 2026년 10월 31일 2026년 10월 31일 2026년 10월 31일
2.0.x 2028년 4월 30일 2029년 4월 30일 2032년 4월 30일

확장 지원(Extended Support)과 지속 확장 지원(Ongoing Extended Support)은 Enterprise 고객이 이용할 수 있는 선택적 유료 지원 패키지라는 점에 유의해요.

2.0.0 릴리스부터 HashiCorp Nomad의 기존 의미론적 버저닝(semantic versioning) 형식(X.Y.Z)은 IBM의 Version-Modification-Fix(V.M.F) 모델로 전환돼요. 이 매핑은 제품 전반에 걸쳐 수명주기 시점을 명확하고 일관되게 만드는 데 도움을 줘요.

  • 4월 ("V" 마일스톤): 해당 버전에 대한 새 지원 수명주기를 시작해요.
  • 10월 ("M" 마일스톤): 새 기능을 추가하지만 새 지원 수명주기는 시작하지 않아요.
  • 매월 ("F" 수정): 패치 릴리스예요.

추가 세부 사항은 다음을 참고해요:

1.10.5 릴리스 하이라이트

Windows OS 개선 사항

키링 구성 검증 (Keyring configuration validation)

에이전트 시작 시 Nomad는 키링 구성 유형을 지원되는 값과 대조해 검증해요.

스케줄링 성능 개선

예약 포트(reserved ports) 사용량을 확인할 때 스케줄링 성능을 개선했어요.

Changelog

버그 및 보안 수정 목록은 changelog를 검토해요.

1.10.4 릴리스 하이라이트

Nomad 로그 및 journald 출력

CLI를 사용해 원격으로 journald 출력 또는 Nomad 로그 파일의 내용을 검색할 수 있는 기능을 추가했어요.

새 monitor export 명령

주어진 Nomad 에이전트에 대해 이 명령은 journald 로그 또는 Nomad 로그 파일의 전체 내용을 검색해요. 사용법, 옵션, 예제는 monitor export 명령 참조를 검토해요.

디버깅을 위한 기록 로그 캡처

nomad operator debug 명령에 다음 플래그를 추가했어요.

  • -log-lookback: 기록 journald 로그를 디버그 캡처에 포함해요.
  • -log-file-export: Nomad 에이전트의 로그 파일을 디버그 캡처에 포함해요.

자세한 내용은 nomad operator debug 명령 참조를 참고해요.

차단된 평가 메트릭 (Blocked evaluation metrics)

nomad.nomad.blocked_evals.cpu 및 nomad.nomad.blocked_evals.memory 서버 메트릭에 이제 node_pool 라벨이 포함돼요. 이는 스케일링 작업이 필요한 노드 풀을 파악하는 데 도움을 줘요.

Metrics 참조의 서버 메트릭을 검토해요.

CSI 볼륨에 대한 Sentinel 정책 범위 (Enterprise)

CSI 볼륨 생성 및 등록에 Sentinel 정책을 적용할 수 있는 새로운 submit-csi-volume Sentinel 정책 범위를 추가했어요.

CSI 볼륨 생성 및 등록에 할당된 soft-mandatory 정책은 재정의(override)할 수 있지만, hard-mandatory 정책은 재정의할 수 없어요. soft-mandatory와 hard-mandatory 정의는 Sentinel Policies API의 EnforcementLevel 파라미터를 참고해요.

다음 문서를 참고해요:

Changelog

버그 수정 목록은 changelog를 검토해요.

1.10.3 릴리스 하이라이트

Consul 서비스 등록

작업 명세(job specification)의 service 블록에 kind 파라미터를 추가했어요. Consul 서비스 종류를 지정하여 Consul 서비스를 수동으로 등록할 수 있어요. Consul 서비스 종류(Kind) 값 목록은 Consul Register Service HTTP API의 Kind 파라미터를 참고해요.

이전에는 작업 명세의 gateway 블록에서 Consul 서비스 메시를 구성했어요. 이제 작업 명세 서비스 자체에서 Consul 서비스 종류를 지정할 수 있어요. 작업 명세에 서비스 종류와 게이트웨이를 모두 구성하면 구성된 Consul 서비스 메시 게이트웨이가 우선해요.

자세한 내용은 작업 명세 service 블록의 kind 파라미터를 참고해요.

Docker 태스크 드라이버 cgroup namespace 지원

작업 명세의 Docker 태스크 드라이버 구성에서 cgroup namespace를 지정할 수 있어요. 이렇게 하면 Datadog Agent와 같이 cgroup namespace가 필요한 서비스를 실행할 수 있어요.

자세한 내용은 Docker 태스크 드라이버의 cgroupns 파라미터를 참고해요.

NOMAD_UNIX_ADDR 태스크 환경 변수

Nomad CLI를 태스크 API의 Unix 소켓과 함께 사용하려면 NOMAD_UNIX_ADDR 값을 NOMAD_ADDR로 사용해요.

이 예제는 NOMAD_ADDR을 NOMAD_UNIX_ADDR 환경 변수로 설정해요.

  driver = "raw_exec"
  config { ... run `nomad` commands ... }
  identity {
    env = true
  }
  env {
    NOMAD_ADDR = "${NOMAD_UNIX_ADDR}"
  }
}

자세한 내용은 다음 리소스를 참고해요:

Changelog

버그 수정 목록은 changelog를 검토해요.

1.10.2 릴리스 하이라이트

중지된 작업 시작 (Start stopped jobs)

nomad job start CLI 명령은 중지된 작업을 시작해요. 이는 실행 중인 작업의 할당을 재시작하거나 재스케줄링하는 nomad job restart 명령과는 달라요.

자세한 내용은 nomad job start 명령 참조를 참고해요.

동적 호스트 볼륨 가비지 컬렉션 개선

노드가 가비지 컬렉션되면 노드의 동적 호스트 볼륨이 상태 저장소에 고아(orphan)로 남아요. 일반적으로 이러한 볼륨을 자동으로 수집하여 데이터 손실 위험을 감수하지는 않으므로, 가비지 컬렉션을 개선하여 고아가 된 동적 호스트 볼륨을 삭제할 수 있게 했어요.

노드가 가비지 컬렉션된 경우 볼륨을 삭제할 수 있도록 nomad volume delete 명령에 -force 플래그를 추가했어요. 자세한 내용은 nomad volume delete 명령 참조를 참고해요.

오토스케일링 그룹의 AWS EC2와 같은 임시 클라우드 인스턴스에서 실행되는 클러스터의 경우 호스트 볼륨 삭제가 과도한 마찰을 유발할 수 있어요. gc_volumes_on_node_gc 클라이언트 구성 파라미터는 가비지 컬렉션이 노드를 삭제할 때 서버가 해당 노드의 동적 호스트 볼륨도 삭제하도록 지정해요. 자세한 내용은 gc_volumes_on_node_gc 파라미터 정의를 참고해요.

최대 할당 수 구성

node_max_allocs 파라미터는 Nomad가 클라이언트 노드에 스케줄링할 수 있는 최대 할당 수를 설정해요. 자세한 내용은 node_max_allocs 파라미터 정의를 참고해요.

워크로드 아이덴티티를 포함한 ACL 정책 개선

IPv6 주소 정규화

IPv6 주소에 RFC-5942 섹션 4 권장 사항을 적용해요. Nomad는 구성 파일을 파싱할 때 주소를 정규화하여 변경 사항이 전체 시스템에 적용되도록 해요.

작업 명세 템플릿을 한 번만 렌더링하는 옵션

template 블록에 once 모드를 추가했어요. 이는 템플릿이 의존성을 감시하지 않고 한 번만 렌더링되도록 해요. 자세한 내용은 다음 리소스를 참고해요.

  • 자세한 설명은 Consul Template Modes Once Mode
  • Nomad 동작 변경에 대한 작업 명세 template 블록의 once 파라미터

오프라인 사용량 보고 (Enterprise)

이 개선으로 Nomad는 상태 저장소에 사용량 메트릭 스냅샷을 주기적으로 기록해요. 에어갭(air-gapped) 또는 보안 환경의 클러스터 관리자는 API나 CLI를 사용해 이러한 사용량 메트릭 스냅샷에서 사용량 보고 번들을 생성할 수 있어요.

다음 리소스를 참고해요:

주요 변경 사항 (Breaking changes)

템플릿에서 이러한 비-헤르메틱(non-hermetic) Sprig 함수에 대한 지원을 제거했어요: sprig_date, sprig_dateInZone, sprig_dateModify, sprig_htmlDate, sprig_htmlDateInZone, sprig_dateInZone, sprig_dateModify, sprig_randAlphaNum, sprig_randAlpha, sprig_randAscii, sprig_randNumeric, sprig_randBytes, sprig_uuidv4, sprig_env, sprig_expandenv, sprig_getHostByName.

앞서 언급한 Sprig 함수는 환경 변수를 읽거나 도메인 이름을 IP 주소로 확인할 수 있게 해 보안 위험이 있었어요.

Changelog

보안 및 버그 수정 목록은 changelog를 검토해요.

업그레이드 세부 사항

Nomad 1.10.2 업그레이드 가이드를 검토해요.

1.10.1 릴리스 하이라이트

파라미터화된 작업의 부모 우선순위 재정의

-priority 플래그를 사용해 파라미터화된 작업의 부모로부터 상속된 우선순위를 재정의해요. 자세한 내용은 nomad job dispatch 명령의 -priority 파라미터를 참고해요.

주요 변경 사항 (Breaking changes)

주소로 Raft 피어 제거 기능 제거

Nomad 1.4.0이 Raft Protocol v2 지원을 제거하면서, 피어 ID 대신 주소로 Raft 피어를 제거하는 기능도 제거됐어요. Nomad 1.10.1은 operator raft peer-remove 명령의 기능하지 않는 -peer-address 옵션과 DELETE /v1/operator/raft/peer API의 address 파라미터를 제거했어요.

구성 리로드 오류 시 에이전트 종료

에이전트 구성 리로드 시 발생하는 오류로 인해 이제 에이전트가 종료돼요. 이전 버전에서는 Nomad가 리로드 중 구성 오류를 로그로만 남겼어요. 이로 인해 에이전트가 실행 중이지만 통신할 수 없는 상황이 발생할 수 있었어요. 새 구성 파싱 중 발생하는 다른 오류는 현재 동작과 일관되게 로그로 남고 리로드가 중단돼요.

Changelog

보안 및 버그 수정 목록은 changelog를 검토해요.

업그레이드 세부 사항

Nomad 1.10.1 업그레이드 가이드를 검토해요.

1.10.0 릴리스 하이라이트

동적 호스트 볼륨 (Dynamic host volumes)

동적 호스트 볼륨 기능은 워크로드 할당에 영구 저장소 옵션을 제공해요.

Nomad 동적 호스트 볼륨은 구성 변경을 적용하기 위해 Nomad 노드를 재시작할 필요 없이 상태 유지 워크로드의 저장소를 관리해요. CLI나 API를 통해 동적 호스트 볼륨을 만든 다음 작업 명세의 volume 및 volume_mount 블록으로 작업을 구성해요.

호스트 볼륨은 Nomad 클라이언트의 마운트 경로를 할당에 마운트해요. Nomad는 호스트 볼륨의 가용성을 인지하고 작업 스케줄링에 활용해요. 다만 Nomad는 볼륨의 기본 특성을 알지 못하기 때문에, 호스트 볼륨을 로컬 영구 저장소와 고가용성 네트워크 저장소 모두에 사용할 수 있어요.

동적 호스트 볼륨 거버넌스 (Enterprise)

공유 Nomad 클러스터에서 호스트 볼륨을 활용할 때 플랫폼 소비자에게 가이드레이(guardrail)를 제공하는 것은 저장소 프로비저닝 워크플로우의 중요한 측면이에요. Nomad Enterprise는 호스트 볼륨 프로비저닝 시 거버넌스를 제공하기 위해 이러한 새로운 기능을 지원해요.

  • Sentinel 동적 호스트 볼륨 객체. 볼륨 생성 중 Nomad는 동적 호스트 볼륨 명세 내의 모든 세부 사항을 특정 패턴을 정의하고 강제하는 Sentinel 정책과 대조해 평가할 수 있어요. 예를 들어 지정된 환경이나 네임스페이스에 따라 저장소 계층을 강제하는 정책은 특정 워크로드에 더 비싼 NVME 저장소를 예약하도록 허용할 수 있어요. 볼륨 명세에 정책을 적용할 수 있게 되면, 플랫폼 소비자에게 셀프 서비스 볼륨 프로비저닝에 대한 더 큰 유연성을 제공하면서 특정 패턴을 강제하는 방법을 제공해요. 자세한 내용은 Sentinel 정책 참조를 참고해요.
  • 리소스 할당량 지원. Nomad의 리소스 할당량 시스템은 이제 특정 네임스페이스 내 프로비저닝된 저장소에 적용할 수 있는 호스트 볼륨 용량 제한을 포함해요. 이는 볼륨 생성 시 정의된 최대 용량 또는 볼륨 수명주기 동안 최대 용량을 업데이트할 때를 기준으로 네임스페이스 내 저장소 소비를 제어하는 데 도움을 줘요. 자세한 내용은 리소스 할당량 명세를 참고해요.
  • 네임스페이스 및 노드 풀 검증: 동적 호스트 볼륨은 생성 시 특정 네임스페이스의 맥락 안에 존재해요. Nomad가 특정 노드 풀을 대상으로 하는 네임스페이스에 볼륨을 프로비저닝할 때, Nomad는 네임스페이스 노드 풀 구성을 평가하여 볼륨 생성이 노드 풀의 작업 배치 규칙과 일치하도록 해요. node_pool_config 파라미터에 대한 자세한 내용은 네임스페이스 명세를 참고해요.
리소스

동적 호스트 볼륨에 대해 자세히 알아보려면 다음 리소스를 참고해요:

OpenID Connect (OIDC) 개선 사항

Nomad 1.10은 Nomad의 OIDC SSO 로그인 기능을 Private Key JWT와 Proof Key for Code Exchange (PKCE)로 확장해요.

Private Key JWT

클라이언트 어서션(client assertions)이라고도 하는 Private Key JWT는 클라이언트 시크릿에 대한 더 안전한 대안이에요. 단순한 시크릿을 보내는 대신 Nomad는 JWT를 구성하고 OIDC 공급자가 검증하는 값으로 서명해요. 이 접근 방식에서 Nomad는 네트워크로 비밀 정보를 전송하지 않고 유효한 OIDC 클라이언트임을 어서션해요.

Proof Key for Code Exchange (PKCE)

PKCE는 클라이언트 시크릿과 클라이언트 어서션 모두에 대해 모든 OIDC 인증 방법에 추가 보안 계층을 제공해요.

이 추가 보안을 켜려면 ACL 인증 방법 OIDCEnablePKCE 파라미터를 true로 설정해요.

모든 OIDC 공급자가 PKCE를 지원하는 것은 아니라는 점에 유의해요. Nomad에서 PKCE를 활성화하는 것 외에도 OIDC 공급자의 구성에서도 이를 활성화해야 할 수 있어요.

리소스

Container Storage Interface (CSI) 개선 사항

다음을 추가했어요:

  • 이벤트 스트림에 CSI 볼륨 및 플러그인 이벤트
  • nomad volume status 명령 출력에 볼륨 기능(capabilities)
  • nomad volume delete 명령에서 볼륨 ID 접두사 검색 및 와일드카드 네임스페이스 사용 기능. 자세한 내용은 GitHub pull request를 참고해요. 사용 예:
==> Created host volume internal-plugin with ID aeea91a0-06df-c16e-5403-ff82a2f28fd4
✓ Host volume "aeea91a0" ready

  2025-01-31T15:55:14-05:00
  ID        = aeea91a0-06df-c16e-5403-ff82a2f28fd4
  Name      = internal-plugin
  Namespace = default
  Plugin ID = mkdir
  Node ID   = b4611abd-d4a8-c83a-b05e-7d9f5b44a179
  Node Pool = default
  Capacity  = 0 B
  State     = ready
  Host Path = /run/nomad/dev/data/host_volumes/aeea91a0-06df-c16e-5403-ff82a2f28fd4

$ nomad volume delete -type host aeea91a0
Successfully deleted volume "aeea91a0-06df-c16e-5403-ff82a2f28fd4"!

CLI 명령에 추가된 UI URL 힌트

일반적인 CLI 명령의 끝에 UI URL 힌트를 추가하고, 생성된 링크를 브라우저에서 자동으로 열어주는 -ui 플래그를 추가했어요.

UI URL 힌트 표시는 기본적으로 활성화돼 있어요. 이 기능을 끄는 두 가지 옵션이 있어요:

  • 서버: 에이전트의 ui 블록 구성에서 show_cli_hints 파라미터를 수정해요.
  • CLI: NOMAD_CLI_SHOW_HINTS 환경 변수를 0 또는 false로 설정해요.
No running jobs

==> View and manage Nomad jobs in the Web UI: https://localhost:4646/ui/jobs

$ export NOMAD_CLI_SHOW_HINTS=0
$ nomad status
No running jobs

주요 변경 사항 (Breaking changes)

할당량 한도에 대한 Go SDK API 변경

Nomad 1.10.0에서 할당량용 Go API에 주요 변경이 있어요. QuotaSpec.RegionLimit 필드의 유형이 이제 Resources가 아닌 QuotaResources예요. QuotaSpec.VariablesLimit 필드는 QuotaSpec.RegionLimit.Storage.Variables로 대체되어 지원 중단되며 Nomad 1.12.0에서 제거될 예정이에요.

구성 없이 plugin_dir에서 바이너리 로드

plugin_dir에 저장된 플러그인은 이제 에이전트 구성 파일에 해당 plugin 블록이 있는 경우에만 로드돼요. Nomad는 이제 구성 블록이 없는 플러그인은 건너뛰어요.

Vault 및 Consul 통합 변경

Nomad 1.10.0은 Vault와 Consul에 대해 이전에 지원 중단되었던 토큰 기반 인증 워크플로우를 제거해요. Nomad 클라이언트는 이제 태스크의 워크로드 아이덴티티를 사용해 Vault와 Consul에 인증하고 태스크 고유의 토큰을 얻어야 해요.

이 표는 제거된 Vault 필드와 새 워크플로우를 나열해요.

필드 구성 새 워크플로우
vault.allow_unauthenticated 에이전트 태스크는 워크로드 아이덴티티를 사용해야 해요. Vault 토큰을 사용하지 마세요.
vault.task_token_ttl 에이전트 워크로드 아이덴티티 사용 시 태스크는 Vault 역할에서 TTL 구성을 받아요.
vault.token 에이전트 Nomad 에이전트는 인증된 엔드포인트에 요청할 때 워크로드 아이덴티티를 사용해요.
vault.policies 작업 명세 Vault 역할을 구성하고 사용해요.

Nomad 1.10으로 업그레이드하기 전에 다음 작업을 수행해요:

  1. Vault와 Consul을 워크로드 아이덴티티와 함께 작동하도록 구성해요.
  2. 모든 워크로드를 워크로드 아이덴티티를 사용하도록 마이그레이션해요.

자세한 내용은 다음 가이드를 참고해요:

Consul 템플릿 암시적 워크로드 아이덴티티 제거

Nomad는 Consul에 서비스를 등록하지 않는 워크로드에 대해 암시적 Consul 아이덴티티를 더 이상 만들지 않아요. 템플릿 렌더링에 Consul 토큰이 필요한 태스크는 consul 블록을 포함하거나 identity를 지정해야 해요.

Nomad 1.8에서 지원 중단된 disconnect 필드 제거

Nomad 1.8에서 max_client_disconnect, stop_after_client_disconnect, prevent_reschedule_on_list 필드를 대체하는 disconnect 블록을 도입했어요. Nomad 1.10에서는 이러한 필드를 제거했으며, 지정해도 Nomad가 무시해요. 작업은 업그레이드 전에 disconnect 블록을 사용하도록 마이그레이션해야 해요.

원격 태스크 드라이버 지원 제거

Nomad 1.10.0에서 원격 태스크 드라이버 기능에 대한 모든 지원을 제거했어요. Nomad는 할당이 손실될 때 RemoteTasks 기능이 있는 드라이버를 더 이상 분리(detach)하지 않아요. 또한 노드가 드레인될 때 원격 태스크를 분리하지 않아요. 원격 태스크로 실행되는 워크로드는 업그레이드 전에 마이그레이션해야 해요.

Sentinel apply 명령에 scope 필수 (Enterprise)

볼륨용 정책을 작업 범위에 실수로 추가하는 것을 방지하기 위해 nomad sentinel apply 명령은 이제 -scope 옵션을 요구해요. 자세한 내용은 GitHub pull request를 참고해요.

Affinity 및 spread 업데이트는 비파괴적

스케줄러 버그를 수정하여 affinity 및 spread 블록에 대한 업데이트가 더 이상 파괴적이지 않도록 했어요. 이 블록들만 변경하는 작업 업데이트 후에는 기존 할당이 작업 버전이 증가한 채 계속 실행돼요. 이전 동작에 의존해 워크로드를 재분배하고 있었다면, meta 블록과 같이 파괴적 업데이트를 요구하는 필드를 변경하여 파괴적 업데이트를 강제할 수 있어요.

지원 중단 사항 (Deprecations)

할당량 명세의 variable_limits 지원 중단 (Enterprise)

할당량 명세의 variable_limits 필드는 지원 중단됐어요. 이를 region_limit 블록 아래의 variables 필드가 있는 새 storage 블록으로 대체했어요. 기존 할당량은 서버 업그레이드 중 자동으로 마이그레이션돼요. Nomad 1.12.0에서 할당량 명세의 variables_limit 필드를 제거할 예정이에요.

업그레이드 세부 사항

더 자세한 정보는 업그레이드 세부 사항 페이지와 GitHub releases changelog를 참고해요.

알려진 문제 (Known issues)

없음.

Changelog

더 알아보기 (Learn more)