Skip to content

Latest commit

 

History

History
92 lines (60 loc) · 2.45 KB

README.md

File metadata and controls

92 lines (60 loc) · 2.45 KB

Nestybox System Container Dockerfiles

This directory contains the Dockerfiles for system container images uploaded to the Nestybox public repos on DockerHub and Github.

The Dockerfiles and associated images are meant to be used as examples.

Feel free to copy them and modify them to your needs, or source them from within your Dockerfiles.

Building the images

  • In general, make sure to build each image for the supported platforms. For example, to build and push the ghcr.io/nestybox/alpine-test image for both amd64 and arm64:
$ docker buildx create --driver=docker-container --name mybuilder --use
$ cd alpine-test
$ docker buildx build --platform linux/amd64,linux/arm64 -t ghcr.io/nestybox/alpine . --push

Pulling a Nestybox system container image

For example, to run the system container image that contains Ubuntu Bionic + Docker, simply type the following:

  • DockerHub registry

    $ docker run --runtime=sysbox-runc -it nestybox/ubuntu-bionic-docker:latest
  • Github registry:

    $ docker run --runtime=sysbox-runc -it ghcr.io/nestybox/ubuntu-bionic-docker:latest

Customizing the system container to your needs

Two approaches: either source the Nestybox image from within your own Dockerfile, or copy the Nestybox Dockerfile and modify it.

The former approach makes sense if you wish to leverage the entire image.

The latter approach makes sense if there is some instruction within the Nestybox Dockerfile that you wish to change.

Sourcing the Nestybox Image

Simply add this at the beginning of your Dockerfile

FROM nestybox/ubuntu-disco-docker:latest

Then add your instructions to the Dockerfile.

Then build the image and tag it:

$ docker build .
$ docker tag <image-tag> my-custom-syscont:latest

And run it with:

$ docker run --runtime=sysbox-runc -it my-custom-syscont:latest

You can then push the image to your own container image repo for later re-use.

Copy the Dockerfile, modify it, and build a new image

First, copy the Nestybox Dockerfile to some directory, cd to that directory, and modify it per your needs.

Then build the image and tag it:

$ docker build .
$ docker tag <image-tag> my-custom-syscont:latest

And run it with:

$ docker run --runtime=sysbox-runc -it my-custom-syscont:latest

You can then push the image to your own container image repo for later re-use.