Managing and Scaling Services

This lesson covers the essentials of managing and dynamically scaling services within your Docker Swarm cluster to meet demand and ensure high availability.

By Kevin McAleer,    4 Minutes

Effective Service Management in Docker Swarm

Once you’ve deployed your application as a stack in Docker Swarm, managing and scaling your services becomes crucial for maintaining performance and availability. Docker Swarm offers built-in tools to help you adjust your services in response to your application’s needs. This lesson will guide you through the processes of managing and scaling services within your Docker Swarm cluster.

Overview of Service Management

Service management in Docker Swarm involves monitoring the state of your services, adjusting configurations, updating images, and scaling services to meet demand. Docker Swarm simplifies these tasks with its declarative model, allowing you to specify desired states for your services which Swarm then maintains.

Scaling Services

Scaling services in Docker Swarm can be done manually or automatically (with third-party tools). To manually scale a service:

  1. Identify the Service: Determine the name or ID of the service you wish to scale. You can list all services in your stack with:

    docker stack services <STACK_NAME>
  2. Scale the Service: Adjust the number of replicas (instances) of your service with the docker service scale command:

    docker service scale <SERVICE_NAME>=<NUM_REPLICAS>

    Replace <SERVICE_NAME> with your service’s name and <NUM_REPLICAS> with the desired number of replicas.

Updating Services

To update a service, such as changing its image or configuration, you can edit your Docker Compose file and redeploy your stack. Docker Swarm will perform a rolling update, minimizing downtime:

  1. Edit Docker Compose File: Make the necessary changes to your service’s configuration in the Docker Compose file.
  2. Redeploy the Stack: Use the docker stack deploy command again with the updated Compose file:

    docker stack deploy -c docker-compose.yml <STACK_NAME>

    Swarm updates the services based on the changes in the Compose file.

Draining and Removing Services

When you need to remove a service from your stack, you can use the docker service rm command. Before removing a service, you may want to drain it to prevent new tasks from being scheduled on it:

  • Drain a Service: Prevent new tasks from being scheduled on a service with:

    docker service update --replicas=0 <SERVICE_NAME>
  • Remove a Service: Once the service is drained, remove it from your stack with:

     docker service rm <SERVICE_NAME>
  • Drain a node: To bring a node down safely, you can drain it to prevent new tasks from being scheduled on it, then remove it from the cluster.

     docker node update --availability drain <NODE_NAME>

Monitoring Service Health

Monitoring is key to managing services effectively. Docker Swarm offers basic monitoring capabilities through service logs and status commands:

  • View Service Logs: To troubleshoot issues or monitor activity, view a service’s logs with:

    docker service logs <SERVICE_NAME>
  • Check Service Status: Use docker service ps <SERVICE_NAME> to check the status of a service’s replicas, including any errors or failures.

Implementing Auto-scaling

While Docker Swarm does not natively support auto-scaling, you can integrate third-party tools like Prometheus and Portainer, or use custom scripts that monitor your services and scale them based on metrics like CPU usage, memory consumption, or request load.

Best Practices for Service Management

  • Regularly Update Images: Keep your service images up-to-date for security and performance improvements.
  • Monitor Resource Usage: Ensure your services have enough resources (CPU, memory) and adjust allocations as necessary.
  • Plan for High Availability: Deploy critical services with multiple replicas across different nodes to ensure redundancy and high availability.


Managing and scaling services are critical aspects of running a successful Docker Swarm cluster. By effectively leveraging Docker Swarm’s service management features, you can ensure your applications remain responsive, available, and up-to-date. As your application’s needs evolve, continue to adjust your service configurations and scaling strategies to maintain optimal performance and reliability.

< Previous Next >