dbohry/local-orquestrator repository overview

⁠Quick reference

• Maintained by: https://github.com/dbohry/local-orquestrator⁠

⁠Local Orchestrator

Lightweight auto-scaler for Docker Swarm services. Monitors container CPU usage across cluster nodes and scales replicas up/down based on configurable thresholds.

⁠How it works

Runs as a single container on a Swarm manager node. Periodically collects CPU stats from all running tasks across the cluster, then adjusts replica counts for services that opt in via labels.

⁠Service Labels

⁠Environment Variables

⁠Usage

services:
  orchestrator:
    image: dbohry/local-orquestrator
    environment:
      - MANAGER_HOST=tcp://manager:2375
      - FREQUENCY=30000
    deploy:
      placement:
        constraints:
          - node.role == manager

  my-app:
    image: my-app:latest
    deploy:
      labels:
        autoscaling: "true"
        min-replicas: "2"
        max-replicas: "10"
        scale-up-cpu: "80"
        scale-down-cpu: "20"
      replicas: 2

⁠Requirements

• Docker Swarm mode
• Docker API exposed on worker nodes (port 2375 by default)

⁠Resource Footprint

Runs with -Xmx32m — designed for always-on operation with minimal overhead.