bretfisher/awesome-swarm

All the awesome tools, docs, and training on Docker and Mirantis Swarm Mode (SwarmKit)

Oh hi 👋

apiVersion: v48
kind: Human
metadata:
  name: Bret Fisher
spec:
  purpose: Help others learn container DevOps
  sponsorship: bretfisher.com/members
  locations:
    - 
      type: YouTube Live Stream on Thursdays
      where: bret.live
    - 
      type: Newsletter
      where: bret.news
    - 
      type: Homepage
      where: bretfisher.com
    - 
      type: Discord Server
      where: devops.fan
    -
      type: Podcast
      where: bretfisher.com/podcast
  favorites:
    number: 42
    animal: 🐶
    emoji: 🤦
    food: 🥩
    drink: 🥃

🙋‍♀️ You can Ask-Me-Anything in my ama repository, or tweet @BretFisher.

💬 Join my 12k+ member DevOps community on Discord: devops.fan.

📰 Read my Cloud Native Newsletter: bret.news

☕️ 🤑 Please support my DevOps YouTube Live show, podcast, and open source content by buying me a coffee every month at bretfisher.com/members!

🧑‍🏫 My course repositories

• All my Udemy course coupon codes: bretfisher.com/courses
• Automate Your Kubernetes Deployments with GitHub Actions and Argo GitOps
• Docker Mastery (with Kubernetes, Swarm, Compose, and more)
• Kubernetes Mastery (go deeper in K8s)
• Docker for Node.js (learn advanced ways to use local Docker with Node.js projects)
• Swarm Mastery (learn more about Docker's built-in orchestrator)
• More DevOps courses coming!

My examples and templates (New stuff on top)

• Awesome Swarm - A list of resources, tools, and learning on Docker/Mirantis Swarm (SwarmKit)
• Kubernetes initContainer Examples and Good Defaults - Learn Kubernetes Init Containers by example, and when to not use them.
• Kubernetes Pod Specification (podspec) Good Defaults - Good Defaults for the most common Kubernetes workloads. Adds security and uptime (optional) features.
• Node.js Rocks in Docker - Video and examples of multi-stage docker builds, k8s healthcheck probes, etc.
• GitHub Actions for Docker: examples and video walkthrough - Video and examples of GitHub Actions for advanced docker builds, automated testing, and CVE scanning.
• GitHub Actions DevOps Templates - reusable GitHub Actions templates for DevOps stuff (linting, docker builds, CVE scanning, etc.)
• Docker Build GitHub Action Template - My custom GitHub Actions workflow using Docker's official build-and-push Actions.
• Super Linter GitHub Action Template - My custom all-in-one linter workflow. I lint all my repositories, and I recommend you do to.
• Node.js Docker Good Defaults - A sample Node.js project that uses Docker.
• Docker Compose local TLS for devs - A sample Compose file that uses a Traefik proxy for TLS, and optionally, Let's Encrypt.
• Docker Build Multi-platform Readme - Explains some ways to build Docker images for multiple platforms in a single Dockerfile.
• Voting App Docker Example - My favorite multi-container example app that I often use to for learning Docker, K8s, CI/CD, and GitOps.
• PHP Docker Good Defaults (outdated) - A sample PHP project that uses Docker.
• Java Docker Petclinic Example - A sample Java project that uses Docker.
• dogvscat Using the voting app in Docker Swarm to explain orchestration, proxies, secrets, and networking.

My tools (often used for learning Containers, Kubernetes, and Docker)

• shpod - Common Kubernetes tools in a single pod.
• httping - Ping with HTTP. Fantastic for testing zero-downtime rolling updates.
• jekyll - Jekyll in a container.
• vackup - Docker Volume backup and restore.
• browncoat - A utility container for simulating failures like slow startup, failing healthchecks, etc.

awesome-swarm's Issues

Clarify contributions of new content

Maybe in the main README.md or the contributing.md, let's clarify:

Do you have an idea for a Swarm Tip or post to help others? Great, however:

Awesome Lists aren't supposed to have actual content. Like Wikipedia, ALs just reference data from other places, not generating new ideas/content.

So, post something elsewhere, and create a PR here if you think it's Awesome enough to list:

• Anyone can make a well-formed Gist
• Make a post at https://swarmkit.org
• Other ways, make a Mastodon post, DEV, or GitHub Pages post. Anything with a perm URL that some corporate entity will eventually sunset access to or slap a random paywall/login in front of.

P.S. We don't like Medium. It might seem easy to post to, but avoid it. Some of us are so anti-medium we usually won't reference articles there. Stay in control of your content. Random paywalls prevent others from consuming it, and we wouldn't want to recommend content that people think is free, but isn't.

More on "No Medium":

• https://nomedium.dev/
• https://twitter.com/BretFisher/status/1206766086961745920

Operating swarm docs

https://containers.goffinet.org/swarm/operatingswarm.html

I stumbled across this one. This seems to have a lot of interesting debugging tips as well.

Decide how to handle subprojects

Description

We should decide on how to handle subprojects of the things we put on this list. Should we only list the main project here, or should we be able to list more subprojects if they are interesting in their own regard?

Background:

We are maintaining swarmsible with some sub projects that build on top of it. One of them is https://github.com/neuroforgede/swarmsible-hetzner which is essentially "one-click-cluster-setup"-tooling for Docker Swarm on Hetzner. Should such projects be in this list or should the respective projects just link to the subprojects?

Add maintainers

Get some of the amazing Swarm fans to pitch in and help maintain this repo.

Add Contributing and PR guides

Start with upstream resources:

https://github.com/sindresorhus/awesome/blob/main/contributing.md

Candidates / Projects needing verification before adding

Are they still useful, can someone try the out and validate they are still "awesome"?

• https://github.com/flavioaiello/swarm-router
• https://gitlab.com/n0r1sk/bosnd
• https://github.com/swarmstack/swarmstack
• https://github.com/mavenugo/swarm-exec (useful for running host cmds on nodes, but running an out of date cli)
• https://github.com/gianarb/orbiter
• https://gist.github.com/thaJeztah/83e7469c85bac28ae90b5178a4919301 alternate way to run swarm with macvlan
• moby/moby#41982 - post in recent CSI PR for ppl to find this.
• https://github.com/jcwimer/docker-swarm-autoscaler - Autoscale Docker Swarm services based on cpu utilization.
• https://github.com/swarmlet/swarmlet
• https://github.com/trajano/docker-volume-plugins
• https://github.com/marcelo-ochoa/docker-volume-plugins
• https://github.com/cuigh/swirl
• https://github.com/wetopi/docker-volume-rbd
• https://github.com/linode/docker-volume-linode
• https://github.com/neuroforgede/docker-swarm-proxy
• https://github.com/djmaze/dobs-volume-plugin

Collection of Stacks:

• https://github.com/YouMightNotNeedKubernetes/

Talks:

• https://www.youtube.com/watch?v=aghIj6A9dxM

Hacks:

• https://gist.github.com/olljanat/b96ed26583c452118313fc18e4a663c1 - Static IPs in Swarm

Decide how to handle Cloud Vendor specific plugins/drivers

Description

We should decide how to keep track of cloud vendor specific things, such as Volume drivers. Should they live in their own section?

Background

I was thinking about adding https://github.com/costela/docker-volume-hetzner especially while the CSI support is not ironclad, but this is specific to one cloud vendor - Hetzner.

dockerswarm.rocks is deprecated

I noticed that the dockerswarm.rocks website listed here is deprecated as of december 2023. They say, "Kubernetes simply won" and "it's not sensitive to build a new product using Docker Swarm Mode".[1] Can you recommend an in-depth discussion about whether or not Docker Engine together with Swarm should be used in production on this topic? Or maybe you guys could take a stand?

[1] https://dockerswarm.rocks/swarm-or-kubernetes/

Notify link owners they are part of Awesome Swarm

Create a template GH Issue to post in repos to let them know:

• they are listed in our Awesome List
• How to add a badge to their repo
• How they can contact us for updates, discussion, etc.

Fix minor readme issues

• Maintainer @ links aren't working at top of readme. I guess this doesn't work in readme's, only issues?
• We now have contributing tutorial and CoC. We likely need to update the bottom of readme.

Space for a "who's using swarm"?

E.g. our project https://coopcloud.tech makes uses of swarm mode.

We have some related docs also https://docs.coopcloud.tech/intro/faq/#why-docker-swarm

Compose Examples

Should we add https://github.com/Haxxnet/Compose-Examples ?

This is not specifically for Swarm, but could be helpful to people to get started with a new stack.

Research and fix/ignore Awesome Lint issues

Our GHA for Awesome Lint throws some issues that I'd like us to fix or ignore. The goal is for it to be a passing "green" check to close this issue.

Some thoughts

• First two are valid and have their own issues. Maybe we can ignore them completely near top of file, for now.
• Some of the double-link are fine in those cases. Maybe we can ignore inline?
• What's the deal with the invalid link URLs?
• Need to troubleshoot what a valid ToC is

Output

README.md:[9](https://github.com/BretFisher/awesome-swarm/actions/runs/4206659805/jobs/7300433704#step:3:10):36
  ✖    1:1    Missing file contributing.md                             remark-lint:awesome-contributing
  ✖    1:1    Git repository must be at least 30 days old              remark-lint:awesome-git-repo-age
  ✖    1:1    Missing or invalid Table of Contents                     remark-lint:awesome-toc
  ✖    9:36   https://www.bretfisher.com                               remark-lint:double-link
  ✖   11:50   https://github.com/BretFisher/awesome-swarm/issues/2     remark-lint:double-link
  ✖   11:1[10](https://github.com/BretFisher/awesome-swarm/actions/runs/4206659805/jobs/7300433704#step:3:11)  CONTRIBUTING.md                                          remark-lint:double-link
  ✖   [11](https://github.com/BretFisher/awesome-swarm/actions/runs/4206659805/jobs/7300433704#step:3:12):189  https://github.com/BretFisher/awesome-swarm/discussions  remark-lint:double-link
  ✖   11:275  https://discord.gg/4jPPynEb2e                            remark-lint:double-link
  ✖   13:3    Invalid list item link URL                               remark-lint:awesome-list-item
  ✖   14:3    Invalid list item link URL                               remark-lint:awesome-list-item
  ✖   15:3    Invalid list item link URL                               remark-lint:awesome-list-item
  ✖   16:3    Invalid list item link URL                               remark-lint:awesome-list-item
  ✖   17:5    Invalid list item link URL                               remark-lint:awesome-list-item
  ✖   18:5    Invalid list item link URL                               remark-lint:awesome-list-item
  ✖   19:5    Invalid list item link URL                               remark-lint:awesome-list-item
  ✖   20:5    Invalid list item link URL                               remark-lint:awesome-list-item
  ✖   21:5    Invalid list item link URL                               remark-lint:awesome-list-item
  ✖   22:3    Invalid list item link URL                               remark-lint:awesome-list-item
  ✖   23:5    Invalid list item link URL                               remark-lint:awesome-list-item
  ✖   24:5    Invalid list item link URL                               remark-lint:awesome-list-item
  ✖   25:3    Invalid list item link URL                               remark-lint:awesome-list-item
  ✖   26:3    Invalid list item link URL                               remark-lint:awesome-list-item
  ✖   27:3    Invalid list item link URL                               remark-lint:awesome-list-item
  ✖   46:71   https://www.bretfisher.com                               remark-lint:double-link
  ✖   47:69   https://www.portainer.io/                                remark-lint:double-link
  ✖   54:3    https://www.portainer.io/                                remark-lint:double-link
  ✖  [12](https://github.com/BretFisher/awesome-swarm/actions/runs/4206659805/jobs/7300433704#step:3:13)1:37   CONTRIBUTING.md                                          remark-lint:double-link
  ✖  121:93   https://github.com/BretFisher/awesome-swarm/issues/2     remark-lint:double-link
  ✖  121:189  https://github.com/BretFisher/awesome-swarm/discussions  remark-lint:double-link
  ✖  121:275  https://discord.gg/4jPPynEb2e                            remark-lint:double-link

Submit this repo to Awesome Lists

After March 15th, Bret should submit this repo to Awesome Lists assuming all requirements are met.