GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - Fewbytes/rubber-docker: A workshop on Linux containers: Rebuild Docker from Scratch

BranchesTags
Open more actions menu

Latest commit

 

History

173 Commits
173 Commits

Folders and files

NameName
Last commit message
Last commit date
docs
docs
 
 
levels
levels
 
 
packer
packer
 
 
slides
slides
 
 
.gitignore
.gitignore
 
 
.gitmodules
.gitmodules
 
 
LICENSE
LICENSE
 
 
Makefile
Makefile
 
 
README.md
README.md
 
 
Vagrantfile
Vagrantfile
 
 
linux.c
linux.c
 
 
pyproject.toml
pyproject.toml
 
 
requirements.txt
requirements.txt
 
 
setup.py
setup.py
 
 

Repository files navigation

Docker From Scratch Workshop

Preparatory Talk

The preparatory talk covers all the basics you'll need for this workshop, including:

  • Linux syscalls and glibc wrappers
  • chroot vs pivot_root
  • namespaces
  • cgroups
  • capabilities
  • and more

The Workshop

Use the provided slides while advancing through the levels, adding more features to your container. Remember to go over each level's readme, and if things get rough - you can always find the solution for level N in the level N+1 skeleton.

The linux python module

Not all the necessary system calls are exposed in python's standard library. In addition, we want to preserve the semantics of the system calls and use them as if we were writing C. We therefore wrote a python module called linux (take a look at linux.c) which exposes the relevant system calls. Have a look at the module documentation for more info.

Quickstart

There are currently 3 options to start the workshop by yourself:

  1. We created a public AMI with the required configuration and utilities already installed:
    Region AMI
    eu-central-1 ami-041c4af571b01d0f8
    il-central-1 ami-036406540dcc4a690
    us-east-1 ami-0cb446a6fd2678063
    us-west-1 ami-0defd345b84194d79
  2. We provide a packer template so you can create your own AMI.
  3. We have a Vagrantfile for you to run using your favorite virtual machine hypervisor (NOTE: not yet fully tested).

The workshop material is checked out at /workshop on the instance:

  • /workshop/rubber-docker - this repository, where you do all the work
  • /workshop/images - images for containers, already populated with ubuntu and busybox images

Before starting the workshop, go over the prep docs in the docs folder.

Start the workshop at /workshop/rubber-docker/levels/00_fork_exec.

Dev environment

If you need to build and install the linux module:

make install 

If you want a distributable wheel package:

make build

PR stuff

This workshop has been publicly given in many places starting February 2016.

  • Opstalk meetup, Tel-Aviv, February 2016
  • DevOps Sydney meetup, Sydney, June 2016
  • DevOpsDays Amsterdam, Amsterdam, June 2016
  • SRECon EU, Dublin, July 2016
  • Sela Developer Practice, Tel-Aviv, June 2016
  • SRECon US, Santa Clara, March 2018
  • DevOpsDays Kiel, Kiel, May 2018

FAQ

Why did you create this?

Because we feel the only way to truly understand something to build it from scratch - and Linux containers are a very hyped and poorly understood technology

Can I use this repository to conduct my own public/private workshop?

Of course! If you do, please consider letting us know on Twitter (@nukemberg and @nocoot) and of course send feedback.

This workshop doesn't cover seccomp/user containers/whatever

Yes, no way we can cover the entire featureset of a real container engine. We tried to concentrate on thing we believe are important for understanding how containers work

I found a bug!

See contributions below

Contributions

Contributions are welcome! If you found a bug or something to improve feel free to open an issue or a pull request. Please note that the entire repository is under MIT license and your contribution will be under that license.

Sponsors

We'd like to thank our friends at Strigo.io for kindly providing their platform, and allowing us to deliver this and other workshops without worrying about infrastructure. If you plan to deliver this workshop yourself, we highly encourage you to contact them.

About

A workshop on Linux containers: Rebuild Docker from Scratch

Resources

Readme
MIT license
Activity
Custom properties

Stars

3.3k stars

Watchers

70 watching

Forks

262 forks
Report repository

Releases

Packages

Used by

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.