Docker:Swarm

lastmod 2026-03-25created 2016-05-3122 edits

Current versions of Docker include swarm mode for natively managing a cluster of Docker Engines called a swarm. Use the Docker CLI to create a swarm, deploy application services to a swarm, and manage swarm behavior.

Display and rotate the root CA

$ docker swarm ca

If the swarm has not been initialized, the following message is printed.

Error response from daemon: This node is not a swarm manager. Use "docker swarm init" or "docker swarm join" to connect this node to swarm and try again.

You need to initialize (docker swarm init or join a swarm docker swarm join.

Initialize a swarm

$ docker swarm init

On successful initialization, the following is printed.

Swarm initialized: current node (4mu50fuj9paosdcor6sjsi4bp) is now a manager.

To add a worker to this swarm, run the following command:

    docker swarm join --token SWMTKN-1-67muwgaig1jyfnpzmyn2yj55o2fcxx1awlrta28ssgwgf9v25i-aal0nt4ytluxowo8g70malidi 192.168.70.21:2377

To add a manager to this swarm, run 'docker swarm join-token manager' and follow the instructions.

On the PC that you want to join the swarm, copy and run the docker swarm join ... command printed above.

docker swarm join --token SWMTKN-1-67muwgaig1jyfnpzmyn2yj55o2fcxx1awlrta28ssgwgf9v25i-aal0nt4ytluxowo8g70malidi 192.168.70.21:2377

Advertise address (advertise addr)

$ docker swarm init --advertise-addr 0.0.0.0:9999

Join a swarm as a node and/or manager

docker swarm join --token SWMTKN-1-67muwgaig1jyfnpzmyn2yj55o2fcxx1awlrta28ssgwgf9v25i-aal0nt4ytluxowo8g70malidi 192.168.70.21:2377

Leave the swarm

docker swarm leave

How to select a node in Swarm

• Stackoverflow - can we deploy a container into a specific node in a docker swarm

Take a look at the Swarm filter docs. You can set various constraints on what node Swarm should pick for any given container. For your case try something like:

docker run ... -e constraint:node==node1 ...

This would start the container on node1.

Checking the Docker Swarm configuration

docker node ls

Container orchestration

• Marathon
• Rancher
• Shipyard
• Kubernetes
• OpenShift
• Swarm
• Mesos

Tools

• portainer

See also

• Docker
• Shipyard
• Dozzle - Real-time log viewer for containers

Favorite site

• Docker Swarm vs. Kubernetes
• About Docker Swarm (ko)
• Docker Swarm: A brief introduction to Docker Swarm and installation guide
• arisu1000.tistory.com: Docker Swarm
• [Recommended] Slideshare: Open Source Consulting: Docker on Cloud(Digital Ocean)
• Docker Swarm
• Presentation on Machine, Swarm, and Compose for Orchestration
• DevOps with Docker
• A DevOps environment for startups - Docker infrastructure
• [Recommended] Easy and fast distributed server management with Docker Swarm ¹
• [Recommended] Zero-downtime deployment of web services with Docker ²
  • See Blue-Green Deployment.
• Building a production architecture with Docker Swarm
• [Recommended] Getting Started with Docker Swarm ³
• [Recommended] High availability of Docker Swarm (how to configure a Swarm cluster to guarantee service availability) ⁴
• [Recommended] Running a Service on Docker Swarm (managing the service lifecycle the Docker Swarm way) ⁵
• [Recommended] A second look at Docker Swarm (a few interesting features related to Docker Labels) ⁶
• [Recommended] Following the development-deployment Flow from the official Docker documentation (using Docker Swarm)
• Docker basics (7/8) Docker Swarm architecture and deploying a Service
• Github - subicura - Docker swarm demo
• [Recommended] A Kubernetes guide for Docker Swarm lovers - Kubernetes from the perspective of someone who knows Docker Swarm

Guide

• Updating Services in a Docker Swarm Mode Cluster

References