The Swarm Orchestrator is a lightweight control service designed to manage and deploy container-based services within a Docker Swarm setup. It serves as the execution backend in the FountainAI ecosystem, dynamically interpreting YAML-based deployment definitions and translating them into real-time, actionable service updates.
This orchestrator provides developers with a clean HTTP API to:
- Deploy, inspect, and remove container services.
- Synchronize the running stack with a versioned
fountainai-stack.ymlfile. - Roll out or roll back updates with intent-aware safety.
-
Clone this repository:
git clone https://github.com/Fountain-Coach/swarm-orchestrator.git cd swarm-orchestrator -
Edit the stack definition: Customize
fountainai-stack.ymlto define your services declaratively. -
Start the orchestrator (locally or via container):
docker build -t swarm-orchestrator . docker run -p 8000:8000 --name swarm swarm-orchestrator -
Ping the health endpoint:
curl http://localhost:8000/v1/health
| Endpoint | Method | Description |
|---|---|---|
/v1/health |
GET | Check service health |
/v1/services |
GET | List all services |
/v1/services/{name} |
GET | Get details of a service |
/v1/services |
POST | Register and deploy a new service |
/v1/services/{name} |
DELETE | Remove a service |
/v1/services/{name}/logs |
GET | Fetch logs for a service |
/v1/stack/sync |
POST | Sync actual Docker state to YAML |
The orchestrator is part of a larger composable system of tools for semantically aware service management and AI-driven planning. Learn more at Fountain-Coach.
Logo: a black-and-white Teatro-style illustration of a minimalist flocking swarm of three birds — simple, abstract, and expressive.
© 2025 Fountain-Coach. All rights reserved.