Docker Service

Swarm에서 개별 서비스의 생성, 확장, 롤링 업데이트, rollback을 관리하는 docker service 그룹.

• 컨테이너 하나가 아니라 desired state를 가진 service 객체를 다룬다.
• scale 과 update 가 운영 시 가장 자주 쓰인다.
• 배포 문제를 볼 때는 service ps 와 service logs 가 핵심이다.

docker service COMMAND

• create: 새 service 생성
  • 주요 옵션: –name, –replicas, –publish, –mount, –network, –constraint, –env, –secret, –config, –update-delay, –update-order
• ls: service 목록
  • 주요 옵션: –filter, –format, -q
• inspect: service spec와 상태 확인
  • 주요 옵션: -f, –pretty
• ps: service task 목록
  • 주요 옵션: –filter, –format, –no-resolve, –no-trunc
• logs: service 또는 task 로그
  • 주요 옵션: -f, –since, –tail, -t, –raw
• scale: replica 수 조정
• update: 이미지, env, network, rollout 정책 변경
  • 주요 옵션: –image, –replicas, –force, –update-parallelism, –update-delay, –rollback-delay
• rollback: 이전 service spec으로 복귀
• rm: service 제거

# 새 service 생성
docker service create --name web --replicas 3 -p 8080:80 nginx:stable
 
# 이미지 업데이트
docker service update --image nginx:1.29 web
 
# 롤아웃 상태 확인
docker service ps web

• task가 반복 재시작되면 service ps 로 배치 이력과 오류 노드를 먼저 본다.
• image pull 실패는 worker 노드 registry 접근 문제일 수 있다.
• rolling update 속도와 실패 허용치는 update 관련 옵션으로 조정한다.

+ docker service --help

Usage:  docker service COMMAND
 
Manage Swarm services
 
Commands:
  create      Create a new service
  inspect     Display detailed information on one or more services
  logs        Fetch the logs of a service or task
  ls          List services
  ps          List the tasks of one or more services
  rm          Remove one or more services
  rollback    Revert changes to a service's configuration
  scale       Scale one or multiple replicated services
  update      Update a service
 
Run 'docker service COMMAND --help' for more information on a command.

+

• docker
• stack
• swarm
• secret
• config

• codex:: 2026-07-06 Added docker service subpage with rollout, scaling, and task inspection notes.