docker service update

docker service update

docker service update는 실행 중인 서비스를 갱신하는 명령이에요. 스웜(Swarm) 서비스의 설정·이미지·마운트·네트워크·롤백 등을 바꿀 때 사용해요.

출처: 문서

본문

docker service update는 지정한 매개변수에 따라 서비스를 갱신해요. 매개변수는 docker service create와 동일해요. 자세한 내용은 그쪽 설명을 참고하세요.

보통 서비스 갱신은 변경 내용이 태스크 재생성을 요구할 때만 새 태스크로 교체돼요. 예를 들어 --update-parallelism 설정만 바꾸면 개별 태스크는 영향을 받지 않으므로 태스크를 재생성하지 않아요. 하지만 --force 플래그는 어떤 변경이 없어도 태스크를 강제로 재생성해요. 이걸로 서비스 매개변수 변경 없이 롤링 재시작을 수행할 수 있어요.

docker service update [OPTIONS] SERVICE

참고: 클러스터 관리 명령이라 스웜 매니저 노드에서 실행해야 해요.

지원하는 옵션은 다음과 같아요.

서비스 갱신

$ docker service update --limit-cpu 2 redis

매개변수 변경 없이 롤링 재시작

$ docker service update --force --update-parallelism 1 --update-delay 30s redis

--force 플래그는 다른 매개변수 변경이 없어도 태스크를 종료하고 새로 교체해요. --update-parallelism 1은 한 번에 하나의 태스크만 교체하게 하고(기본 동작), --update-delay 30s는 태스크 사이에 30초 지연을 넣어 롤링 재시작이 점진적으로 일어나게 해요.

마운트 추가·제거 (--mount-add, --mount-rm)

--mount-add나 --mount-rm으로 서비스의 바인드 마운트 또는 볼륨을 추가·제거해요. --mount-add는 service create의 --mount와 같은 매개변수를 받고, --mount-rm은 마운트의 target 경로를 받아요.

$ docker service create \
    --name=myservice \
    --mount type=volume,source=test-data,target=/somewhere \
    nginx:alpine

myservice

$ docker service update \
    --mount-add type=volume,source=other-volume,target=/somewhere-else \
    myservice

myservice

$ docker service update --mount-rm /somewhere myservice

myservice

게시된 포트 추가·제거 (--publish-add, --publish-rm)

--publish-add/--publish-rm으로 서비스의 게시된 포트를 추가·제거해요.

$ docker service update \
  --publish-add published=8080,target=80 \
  myservice

네트워크 추가·제거 (--network-add, --network-rm)

$ docker service update \
  --network-rm my-network \
  --network-add name=my-network,alias=web1 \
  myservice

이전 버전으로 롤백 (--rollback)

--rollback 옵션으로 서비스의 이전 버전으로 롤백할 수 있어요. 가장 최근 docker service update 전의 설정으로 되돌려요.

$ docker service update --replicas=5 web
...
$ docker service update --rollback web
web

$ docker service ls
ID            NAME  MODE        REPLICAS  IMAGE
80bvrzp6vxf3  web   replicated  0/4       nginx:alpine

--rollback과 다른 옵션을 함께 쓸 수도 있어요. 예를 들어 --update-delay 0s로 태스크 사이 지연 없이 롤백을 실행할 수 있어요.

갱신 실패 시 이전 버전으로 자동 롤백하도록 서비스를 설정할 수도 있어요. --update-failure-action=rollback을 쓰면 되고, --update-max-failure-ratio로 준 값보다 갱신에 실패한 태스크 비율이 크면 롤백이 발동해요.

롤백의 속도·병렬도·기타 매개변수는 --rollback-delay, --rollback-failure-action, --rollback-max-failure-ratio, --rollback-monitor, --rollback-parallelism 플래그가 정해요.

시크릿 추가·제거 (--secret-add, --secret-rm)

$ docker service update \
    --secret-add source=ssh-2,target=ssh-2 \
    --secret-rm ssh-1 \
    myservice

잡(Job) 갱신

서비스를 잡으로 만들면(모드 replicated-job이나 global-job) 갱신 옵션은 제한돼요. 잡을 갱신하면 진행 중인 태스크가 즉시 멈추고 새 태스크 세트가 만들어져 완료 상태가 초기화돼요. 잡은 롤아웃이나 롤백이 불가능하고, 갱신·롤백 설정용 플래그는 잡 모드에서 유효하지 않아요. 잡을 같은 매개변수로 다시 실행하려면 --force 플래그로 강제 갱신하면 돼요.

더 알아보기

• docker service create
• docker service scale
• docker service