Configuration for Docker Swarm and NFS distributed file system mounted on an expandable block volume with daily rsnapshot backups, provisioned by Digital Ocean's doctl. Application swarms will run Traefik as a reverse proxy for Docker services, Portainer for stack management, as well as VS Code in an Alpine environment for development.
This platform isn't intended to be installed on an existing system. Instead, it
includes a nf swarm CLI tool which provisions a cluster of servers from Digital
Ocean and installs itself there.
# Create new swarmfile:
nf swarm create abc.example.com
# Provision resources:
nf swarm provision abc.example.com
# After 5-10 minutes, deploy swarm:
nf swarm deploy abc.example.com
Since nf swarm is just a Bash script, a new cluster can be bootstrapped from any
terminal like so:
# Create new swarmfile:
bash <(curl -fsSL https://github.com/nonfiction/platform/raw/v2/swarm/swarm) create abc.example.com
# Provision resources:
bash <(curl -fsSL https://github.com/nonfiction/platform/raw/v2/swarm/swarm) provision abc.example.com
# After 5-10 minutes, deploy swarm:
bash <(curl -fsSL https://github.com/nonfiction/platform/raw/v2/swarm/swarm) deploy abc.example.com
- Create new tag
swarmby adding it to an arbitrary droplet - APIs -> Tokens/Keys -> Generate New Token
- Container Registry -> Create Registry
- Databases -> Create MySQL Database Cluster
- Networking -> Domains -> Add Domain
- Networking -> Firewalls -> Create Firewall
Create and manage swarms from the command line:
# Create new swarmfile:
nf swarm create abc.example.com
# Edit swarmfile:
nf swarm edit abc.example.com
# Import swarmfile:
nf swarm import ~/xyz_example_com.txt
# Export swarmfile:
nf swarm export xyz.example.com
# Provision resources:
nf swarm provision abc.example.com
# After 5-10 minutes, deploy swarm:
nf swarm deploy abc.example.com
# Provision three replicas:
nf swarm provision abc.example.com +3
# Remove specific replica:
nf swarm provision abc.example.com -abc02
# SSH into the first replica of this swarm:
nf swarm ssh abc.nfweb.ca abc01
# List these commands:
nf swarm help
These are to be run on a separate server not involved in the swarm being managed:
# Increase each node's volume size to 20GB:
nf swarm size abc.example.com 20
# Increase each node's droplet memory to 2GB:
nf swarm size abc.example.com s-1vcpu-2gb
# Remove a swarm
nf swarm remove abc.example.com
These are to be run on the primary node in the swarm:
init -- Create data directories & files"
stack -- Generate compose stacks in deploy directory"
pull -- Pull docker images"
traefik -- Deploy traefik stack (app role)"
workspace -- Deploy workspace stack (dev role)"