Docker Swarm 클러스터 — 서비스 배포와 스케일링 완전 가이드

# 매니저가 될 노드에서 (--advertise-addr 는 다른 노드가 접속할 IP)
docker swarm init --advertise-addr 192.168.1.10
# Swarm initialized. To add a worker ... docker swarm join --token SWMTKN-1-...

# init 출력의 join 명령을 워커 노드에서 실행
docker swarm join --token SWMTKN-1-xxxx 192.168.1.10:2377

docker swarm join-token worker      # 워커용
docker swarm join-token manager     # 매니저용

docker node ls
# ID          HOSTNAME   STATUS   AVAILABILITY   MANAGER STATUS
# abc * ...   node1      Ready    Active         Leader
# def ...     node2      Ready    Active

# nginx 서비스 3개 복제본으로 배포, 80포트 외부 노출
docker service create --name web --replicas 3 -p 80:80 nginx:1.27

docker service ls
docker service ps web      # 어느 노드에서 도는지 태스크 단위 확인

docker service scale web=5
# 또는
docker service update --replicas 5 web

docker rm -f <task-container>     # 워커 노드에서 강제 종료
docker service ps web             # 자동으로 새 태스크가 재생성됨

# ingress(기본): 모든 노드에서 접근 + 부하분산
docker service create --name web -p 80:80 nginx

# host: 해당 컨테이너가 실제로 있는 노드에서만 노출
docker service create --name web \
  --publish published=80,target=80,mode=host nginx

docker network create --driver overlay --attachable appnet

docker service create --name api --network appnet myapi:1.0
docker service create --name web --network appnet -p 80:80 myweb:1.0
# web 컨테이너 안에서 'http://api:8080' 으로 접근 가능 (내장 VIP 로드밸런싱)

docker service create --name web --replicas 4 \
  --update-parallelism 1 \          # 한 번에 1개씩
  --update-delay 10s \              # 사이 10초 대기
  --update-failure-action rollback \ # 실패 시 자동 롤백
  nginx:1.26

# 이미지 교체 → 무중단 롤링
docker service update --image nginx:1.27 web

# 수동 롤백
docker service rollback web

# stack.yml
version: "3.9"
services:
  web:
    image: myweb:1.0
    ports: ["80:80"]
    networks: [appnet]
    deploy:
      replicas: 3
      update_config: { parallelism: 1, delay: 10s }
      restart_policy: { condition: on-failure }
      placement:
        constraints: [node.role == worker]   # 워커에만 배치
  api:
    image: myapi:1.0
    networks: [appnet]
    deploy:
      replicas: 2
      resources:
        limits: { cpus: "0.5", memory: 256M }
networks:
  appnet: { driver: overlay }

docker stack deploy -c stack.yml myapp
docker stack services myapp
docker stack ps myapp
docker stack rm myapp

echo "S3cr3t!23" | docker secret create db_pass -

docker service create --name api \
  --secret db_pass myapi:1.0
# 컨테이너 안: cat /run/secrets/db_pass

docker service logs -f web              # 서비스 로그 집계
docker node update --availability drain node2   # 노드 비우기(점검 전)
docker node update --availability active node2  # 복귀
docker node rm node2                    # 워커 제거(먼저 drain 권장)
docker swarm leave                      # 워커가 클러스터 탈퇴
docker swarm leave --force              # 매니저 강제 탈퇴