Stacks rather than compose, constraints, replicas, rolling updates & self healing

A Docker Stack is a higher-level abstraction in Docker used to deploy and manage a group of services on a Docker Swarm cluster. It is the Swarm-native way of orchestrating multi-container applications — similar to Docker Compose — but optimized for production and multi-node clusters.

Stacks allow you to define entire applications (services, networks, volumes, secrets, configs) in a single YAML file and deploy them across a distributed set of nodes.

Docker Compose vs Docker Stack

Not all Compose features work with Docker Stack (Swarm mode):

• build: is limited or unsupported (use docker build beforehand).
• depends_on: is ignored.
• container_name: is ignored (since services get auto-named).
• Volumes must be defined properly; anonymous volumes behave differently.
• healthcheck: behaviour may be limited in Swarm context.

Docker Stack YAML File

Docker Stack uses the same docker-compose.yml format, but not every Compose option is supported (e.g., depends_on, build in Swarm mode is limited).

Deploying a stack:

This command will:

• Create services from your YAML file.
• Deploy them across the Swarm nodes.
• Manage networks, volumes, secrets as Swarm-scoped resources.

Managing stacks

Show all stacks running in the Swarm:

List all tasks (containers) running under that stack:

List services running in the stack:

Remove the entire stack (services, networks, etc):

Updating a stack

The best way to update a stack, is to update the compose file with any changes, and then redeploy the stack. That way the compose file will always be correct for the stack that is deployed. This is the prefered approach over making individual updates via the CLI as it means looking at the compose file is the current state and one source of truth. So make changes to that and redeploy.

You can make changes to your Compose file and then run:

Docker will:

• Compare the changes,
• Apply rolling updates (where possible),
• Avoid downtime (if correctly configured).

Stack Compose File Syntax for Deployments

When using Docker Stack, service-level deployment settings go under the deploy: key in your docker-compose.yml file. This is Swarm-specific and not supported by standard docker compose up.

Basic structure:

Replicas - defines the number of instances of the service to run. Swarm will spread them across the cluster as needed:

placement.constraints - control where services run based on node labels, roles, or system attributes:

Note: you can add labels to nodes by calling: docker node update --label-add type=api <node-id>.

Define resource limits and reservations:

Limits enforce caps; reservations help Swarm schedule based on available resources.

Define how Swarm restarts a failed container:

Customise rolling update behaviour:

Configures rollback behavior if an update fails:

Global - Instead of specifying replicas, you can run one instance per node:

All these combined as an example: