Docker Node

Swarm cluster 노드 역할과 스케줄링 metadata를 관리하는 docker node 그룹.

• manager/worker 역할 전환, 라벨 변경, node drain 같은 운영 작업에 사용한다.
• service task가 어디에 배치됐는지 보려면 node ps 와 service ps 를 함께 본다.
• node 삭제는 장애 노드 정리나 cluster 축소 시 사용한다.

docker node COMMAND

• ls: cluster 노드 목록
  • 주요 옵션: –format, -q
• inspect: node 상세 정보
  • 주요 옵션: -f, –pretty
• update: 가용성이나 label 수정
  • 주요 옵션: –availability active|pause|drain, –label-add, –label-rm, –role
• promote / demote: manager 승격/강등
• ps: 특정 노드에서 도는 task 목록
  • 주요 옵션: –filter, –format, –no-resolve, –no-trunc
• rm: cluster에서 노드 제거
  • 주요 옵션: -f

# 노드 목록
docker node ls
 
# 특정 노드를 drain으로 전환
docker node update --availability drain worker-02
 
# manager 승격
docker node promote worker-03

• drain 상태 노드는 새 task를 받지 않는다. 유지보수 후 다시 active 로 돌려야 한다.
• manager quorum을 무너뜨릴 수 있으므로 demote 와 rm 은 순서를 신중히 잡는다.

+ docker node --help

Usage:  docker node COMMAND
 
Manage Swarm nodes
 
Commands:
  demote      Demote one or more nodes from manager in the swarm
  inspect     Display detailed information on one or more nodes
  ls          List nodes in the swarm
  promote     Promote one or more nodes to manager in the swarm
  ps          List tasks running on one or more nodes, defaults to current node
  rm          Remove one or more nodes from the swarm
  update      Update a node
 
Run 'docker node COMMAND --help' for more information on a command.

+

• docker
• swarm
• service

• codex:: 2026-07-06 Added docker node subpage with availability, labels, and role-management notes.