Ansible Docker Swarm Cluster

Create and deploy an n-node docker swarm cluster in minutes, with Traefik as a reverse proxy and load balancer, Portainer to manage containers and Jenkins as a CI/CD solution (this is a customized Jenkins docker image whose Jobs can interact with docker).

Prerequisites

• One or more servers running Ubuntu 20.04 connected through a private network (tests were done using GCP).
• Ansible.
• SSH access to these servers using your public key (you can achieve this by simply using ssh-copy-id <hostname>).

Preparation

First clone this repo to your local machine

git clone https://github.com/rodrigoegimenez/ansible-docker-swarm-cluster.git
cd ansible-docker-swarm-cluster

Then edit the hosts file by replacing the ip of your main server and replacing/adding as many nodes as you wish to join your server (if just starting you can just have your main server and add nodes later on). Then create an extra-vars.yml using the example as a guide.

Running

Once finished editing your hosts file you can run all the required commands using the provided Makefile that will launch the appropiate playbook:

make swarm-cluster

This command will start running the imported playbooks in the order they appear:

- import_playbook: docker-dependencies.yml
- import_playbook: main.yml
- import_playbook: workers.yml
- import_playbook: traefik/traefik.yml
- import_playbook: portainer/portainer.yml
- import_playbook: jenkins/jenkins.yml

After a couple minutes the cluster will be up and initialized and ansible will start to install traefik and the other services asking a prompt for user, password and email (for traefik), and for the domain names for all three services (to use with traefik reverse proxy). Make sure you point these (sub)domains to the main's public ip address.

A couple of more minutes and you should have your cluster up and running.

Acknowledgement

This idea is heavily influenced by Docker Swarm Rocks. Traefik and portainer's compose files were obtained from this guide.

Another source of inspiration, specially for the ansible part, was this DigitalOcean's guide to create a Kubernetes Cluster.