Gentoo Docker Images
A collection of Dockerfiles for generating Gentoo docker images.
These images are intended to be created automatically by
a cron job and pushed to docker hub.
This repository include basic stage3 images and an image usable as a /var/db/repos/gentoo
volume
DockerHub
https://hub.docker.com/u/gentoo/
Inventory
The following targets are built and pushed to Docker Hub:
portage
stage3
amd64
stage3-amd64-hardened-nomultilib-openrc
stage3-amd64-hardened-openrc
stage3-amd64-musl
stage3-amd64-musl-hardened
stage3-amd64-nomultilib-openrc
stage3-amd64-nomultilib-systemd
stage3-amd64-openrc
stage3-amd64-desktop-openrc
stage3-amd64-systemd
arm
stage3-armv5tel-openrc
stage3-armv5tel-systemd
stage3-armv6j-openrc
stage3-armv6j-systemd
stage3-armv6j_hardfp-openrc
stage3-armv6j_hardfp-systemd
stage3-armv7a-openrc
stage3-armv7a-systemd
stage3-armv7a_hardfp_musl-openrc
stage3-armv7a_hardfp-openrc
stage3-armv7a_hardfp-systemd
arm64
stage3-arm64-desktop-openrc
stage3-arm64-desktop-systemd
stage3-arm64-musl
stage3-arm64-musl-hardened
stage3-arm64-openrc
stage3-arm64-systemd
ppc
stage3-ppc64le-musl-hardened-openrc
stage3-ppc64le-openrc
stage3-ppc64le-systemd
riscv
stage3-rv64_lp64-openrc
stage3-rv64_lp64-systemd
stage3-rv64_lp64d-openrc
stage3-rv64_lp64d-systemd
s390
stage3-s390x
x86
stage3-i686-hardened-openrc
stage3-i686-musl
stage3-i686-openrc
stage3-i686-systemd
The following upstream stage3 targets are not built at all:
amd64
stage3-amd64
[deprecated]stage3-amd64-hardened
[deprecated]stage3-amd64-hardened+nomultilib
[deprecated]stage3-amd64-hardened-selinux
[deprecated, selinux]stage3-amd64-hardened-selinux+nomultilib
[deprecated, selinux]stage3-amd64-hardened-selinux-openrc
[selinux]stage3-amd64-musl-vanilla
[deprecated]stage3-amd64-nomultilib
[deprecated]stage3-amd64-nomultilib-selinux-openrc
[selinux]stage3-amd64-uclibc-hardened
[deprecated]stage3-amd64-uclibc-vanilla
[deprecated]stage3-x32
[deprecated, unsupported]stage3-x32-openrc
[unsupported]
arm
stage3-armv4tl
[unsupported]stage3-armv4tl-systemd
[unsupported]
ppc
stage3-power9le-openrc
[unsupported]stage3-power9le-systemd
[unsupported]stage3-ppc
[deprecated, unsupported]stage3-ppc-openrc
[unsupported]stage3-ppc64
[deprecated, unsupported]stage3-ppc64-musl-hardened
[deprecated, unsupported]stage3-ppc64-musl-hardened-openrc
[unsupported]stage3-ppc64-openrc
[unsupported]stage3-ppc64-systemd
[unsupported]stage3-ppc64le
[deprecated]stage3-ppc64le-musl-hardened
[deprecated]
riscv
stage3-rv32_*
[unsupported]stage3-rv64_multilib
[under testing]
s390
stage3-s390
[unsupported]
x86
stage3-i486
[deprecated, unsupported]stage3-i486-openrc
[unsupported]stage3-i686
[deprecated]stage3-i686-hardened
[deprecated]stage3-i686-musl-vanilla
[deprecated]stage3-i686-uclibc-hardened
[deprecated]stage3-i686-uclibc-vanilla
[deprecated]
[deprecated]: Deprecated stage3 target
[selinux]: SELinux doesn't seem to make sense inside containers
[under testing]: Not ready for container. Our arch team is working on testing it
[unsupported]: Unsupported Docker architecture
Building the containers
The containers are created using a multi-stage build, which requires Docker >= 19.03.0. The container being built is defined by the TARGET environment variable:
TARGET=stage3-amd64 ./build.sh
Using the portage container as a data volume
docker create -v /var/db/repos/gentoo --name myportagesnapshot gentoo/portage:latest /bin/true
docker run --interactive --tty --volumes-from myportagesnapshot gentoo/stage3:latest /bin/bash
Using the portage container in a multi-stage build
docker-17.05.0 or later supports multi-stage builds, allowing the portage volume to be used when creating images based on a stage3 image.
Example Dockerfile
# name the portage image
FROM gentoo/portage:latest as portage
# based on stage3 image
FROM gentoo/stage3:latest
# copy the entire portage volume in
COPY --from=portage /var/db/repos/gentoo /var/db/repos/gentoo
# continue with image build ...
RUN emerge -qv www-servers/apache # or whichever packages you need
Contributing
We'd love to hear any ideas. Feel free to contact us via any of the following methods:
- IRC: irc://irc.libera.chat:6697/#gentoo-containers
- EMAIL: [email protected]
- GITHUB: https://github.com/gentoo/gentoo-docker-images
Policy
- Use topic branches (i.e. foo) and fix branches (i.e. fix/foo) when submitting pull requests
- Make meaningful commits ideally with the following form:
- Subject line–what this commit does
- Blank line
- Body–why this commit is necessary or desired
- Pull requests should not include merge commits
- Use amend and rebase to fix commits after a pull request has been submitted