This repository (formerly known as
contains materials (slides, scripts, demo app, and other
code samples) used for various workshops, tutorials, and
training sessions around the themes of Docker, containers,
For the moment, it includes:
These materials have been designed around the following principles:
If you're looking for the materials, you can stop reading right now, and hop to http://container.training/, which hosts all the slides decks available.
The rest of this document explains how this repository is structured, and how to use it to deliver (or create) your own tutorials.
All these materials have been gathered in a single repository because they have a few things in common:
Introduction to Docker is derived from the first "Docker Fundamentals" training materials. For more information, see jpetazzo/intro-to-docker. The version in this repository has been adapted to the Markdown publishing pipeline. It is still maintained, but only receives minor updates once in a while.
Container Orchestration with Docker Swarm (formerly known as "Orchestration Workshop") is a workshop created by Jrme Petazzoni in June 2015. Since then, it has been continuously updated and improved, and received contributions from many others authors. It is actively maintained.
Container Orchestration with Kubernetes was created by Jrme Petazzoni in October 2017, with help and feedback from a few other contributors. It is actively maintained.
(This applies only for the orchestration workshops.)
The workshop introduces a demo app, "DockerCoins," built around a micro-services architecture. First, we run it on a single node, using Docker Compose. Then, we pretend that we need to scale it, and we use an orchestrator (SwarmKit or Kubernetes) to deploy and scale the app on a cluster.
We explain the concepts of the orchestrator. For SwarmKit,
we setup the cluster with
docker swarm init and
docker swarm join.
For Kubernetes, we use pre-configured clusters.
Then, we cover more advanced concepts: scaling, load balancing, updates, global services or daemon sets.
There are a number of advanced optional chapters about logging, metrics, secrets, network encryption, etc.
The content is very modular: it is broken down in a large number of Markdown files, that are put together according to a YAML manifest. This allows to re-use content between different workshops very easily.
The sample app is in the
It's used during all chapters
for explaining different concepts of orchestration.
To see it in action:
cd dockercoins && docker-compose up -d
If you want to deliver one of these workshops yourself, this section is for you!
*This section has been mostly contributed by Bret Fisher, who was one of the first persons to have the bravery of delivering this workshop without me. Thanks Bret!
dockercoinsrepo's and the steps we go through to get to a full Swarm Mode cluster of many containers. You'll update the first few slides and last slide at a minimum, with your info.
prepare-vmsyou'll find scripts to create EC2 instances, install docker, pre-pull images, and even print "cards" to place at each students seat with IP's and username/password.
ssh github.comand get
permission denied (publickey)then they know it worked, and SSH is properly installed and they don't have anything blocking it. SSH and a browser are all they need for class.
workshopctlcommands from a dedicated instance you have in same region as instances you want to create. Much faster this way if you're on poor internet. Also, create 2 sets of servers for yourself, and use one during workshop and the 2nd is a backup.
prepare-vms/workshopctl is the script that gets you most of what you need for
setting up instances. See
for all the info on tools and scripts.
With all the slides, this workshop is a full day long. If you need to deliver
it in shorter timelines, here's some recommendations on what to cut out. You
??? which will hide slides. Or leave them there and
add something like
(EXTRA CREDIT) to title so students can still view the
content but you also know to skip during presentation.
There are pre-built images for the 4 components of the DockerCoins demo app:
dockercoins/worker:v0.1. They correspond to the code in this repository.
There are also three variants, for demo purposes:
dockercoins/rng:v0.2is broken (the server won't even start),
dockercoins/webui:v0.2has bigger font on the Y axis and a green graph (instead of blue),
dockercoins/worker:v0.2is 11x slower than
Since its inception, this workshop has been delivered dozens of times, to thousands of people, and has continuously evolved. This is a short history of the first times it was delivered. Look also in the "tags" of this repository: they all correspond to successive iterations of this workshop. If you attended a past version of the workshop, you can use these tags to see what has changed since then.
If there is a bug and you can fix it: submit a PR. Make sure that I know who you are so that I can thank you (because you're the real MVP!)
If there is a bug and you can't fix it, but you can reproduce it: submit an issue explaining how to reproduce.
If there is a bug and you can't even reproduce it: sorry. It is probably an Heisenbug. We can't act on it until it's reproducible, alas.
If you have attended one of these workshops, and want your team or organization to attend a similar one, you can look at the list of upcoming events on http://container.training/.
You are also welcome to reuse these materials to run your own workshop, for your team or even at a meetup or conference. In that case, you might enjoy watching Bridget Kromhout's talk at KubeCon 2018 Europe, explaining precisely how to run such a workshop yourself.
Finally, you can also contact the following persons, who are experienced speakers, are familiar with the material, and are available to deliver these workshops at your conference or for your company:
(If you are willing and able to deliver such workshops, feel free to submit a PR to add your name to that list!)