• Website: https://dataman-cloud.github.io/swan-site

Swan is a Mesos framework forcus on long running tasks, which inspired by Marathon, written with Golang and base on latest Mesos HTTP API.

With Swan you can deploy long running application on mesos cluster, control lifecycle of the application, scale up or scale down any instances size you want, can also do rolling-update with new versions base on flexible health checks defined by you. Swan also designed for high avaliability which means any server crash wouldn't affect running applications. with service discovery and API gateway build-in, service discovery made easy.

• Application deployment
• Application scaling
• Build in HTTP Proxy, Load Balance
• Rolling upgrade
• Version rollback
• Health check
• Auto failover
• High Availability with Raft backend
• Build in DNS

clone Swan source code from github.com:

  git clone [email protected]:Dataman-Cloud/swan.git

Then you can compile Swan with:

  make
  
  # or build within docker
  
  make docker-build

  make docker-run-manager-init 

  make docker-run-manager-join

  make docker-run-agent

• application deployment

  curl -X POST -H "Content-Type: application/json" -d@example/template-replicates.json http://localhost:9999/v_beta/apps

• applications list

  curl http://localhost:9999/v_beta/apps

• application show

  curl http://localhost:9999/v_beta/apps/nginx0003-xcm-unnamed

• application delete

  curl -X DELETE http://localhost:9999/v_beta/apps/nginx0003-xcm-unnamed

• application scale up

  curl -X PATCH -H "Content-Type: application/json" http://localhost:9999/v_beta/apps/nginx0003-xcm-unnamed/scale-up -d '{"instances": 2}'

• application scale down

  curl -X PATCH -H "Content-Type: application/json" http://localhost:9999/v_beta/apps/nginx0003-xcm-unamed/scale-down -d '{"instances": 2}'

• application rolling upgrade

  curl -X PUT -H "Content-Type: application/json" -d@new_verison.json http://localhost:9999/v_beta/apps/nginx0003-xcm-unnamed

• proceed upgrade process

  curl -X PATCH -H "Content-Type: application/json" http://localhost:9999/v_beta/apps/nginx0003-xcm-unnamed/proceed-update -d'{"instances": $NUM}'

instances -1 means upgrading all instances at once. Any other value specifies the number of instances to be updated at the same time.

• cancel upgrade process

  curl -X PATCH -H "Content-Type: application/json" http://localhost:9999/v_beta/apps/nginx0003-xcm-unnamed/cancel-update

• list application versions

  curl http://localhost:9999/v_beta/apps/nginx0003-xcm-unnamed/versions

• get application version

  curl http://localhost:9999/v_beta/apps/nginx0003-xcm-unnamed/versions/14012934223

See ROADMAP for the full roadmap.

If you want to contribute to swan, make a PR or report a issue. The goal of swan is to become the default and best scheduler for mesos, so let's do it!

Swan is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.