How do I use this project?

[firehalt]

Hey, thanks for this project!my Swarm cluster with 3+ manager and 3+ worker node，How do I use it? I install docker swarm cluster on my own. I don't use portworx or etcd.How do I modify docker-compose.yml?

[mh720]

You should follow along the SWARMSTACK INSTALLATION instructions within https://github.com/swarmstack/swarmstack/blob/master/README.md in order to deploy etcd and portworx to your swarm cluster.

Afterwards, running the command below:

ansible-playbook -i clusters/swarmstack playbooks/swarmstack.yml -k

will create a local copy of swarmstack in /usr/local/src/localswarmstack and deploy it. If you need to make changes to the defaults afterwards:

1. docker stack rm swarmstack
2. make any changes to your /usr/local/src/localswarmstack (note: re-running the swarmstack.yml playbook above will detect that /usr/local/src/localswarmstack already exists and will not overwrite anything in that directory).
3. You can either just re-run the swarmstack.yml playbook as above, which will detect that swarmstack isn't running in Docker and will re-deploy your /usr/local/src/localswarmstack version, or you can do it manually:
   cd /usr/local/src/localswarmstack
   ADMIN_PASSWORD='some!password' docker stack deploy -c docker-compose.yml swarmstack

If you don't want to use portworx (which needs etcd for HA), you'll need to supply some other type of persistent storage that Docker can move across hosts in your swarm, and alter your /usr/local/src/localswarmstack/docker-compose.yml to change the storage driver from 'pxd' to your own (such as driver: rexray/ebs) before performing steps 1 and 3 above.

I'll get around to updating the installation and especially the upgrading docs to reflect this.
The main README documentation is much better now :)

Thanks for trying out swarmstack!

[mh720]

There is also now a docker-compose-singlebox.yml that will allow you to install just the DevOps tool stack (Prometheus/Grafana/Alertmanager/NetData/Portainer/Unsee) onto a single EL7 or macOS host with Docker installed, and without any etcd/Portworx storage or the related Grafana graphs and alerts, ansible playbooks are not used when deploying this stack.