andzuc/gentoo-stage3-amd64 repository overview

⁠Gentoo Docker Images

A collection of Dockerfiles for generating Gentoo docker images.

These images are intended to be created automatically by a travis cron job and pushed to docker hub⁠. This repository include basic stage3 images and an image usable as a /usr/portage volume

⁠DockerHub

https://hub.docker.com/u/gentoo/⁠

⁠Inventory

The following targets are built by Travis and pushed to Docker Hub:

• portage
• stage3
  • amd64
    • stage3-amd64
    • stage3-amd64-hardened
    • stage3-amd64-hardened-nomultilib
    • stage3-amd64-musl-hardened
    • stage3-amd64-musl-vanilla
    • stage3-amd64-nomultilib
    • stage3-amd64-systemd
    • stage3-amd64-uclibc-hardened
    • stage3-amd64-uclibc-vanilla
  • arm64
    • stage3-arm64
    • stage3-arm64-systemd
  • arm
    • stage3-armv5tel
    • stage3-armv6j_hardfp
    • stage3-armv7a_hardfp
  • ppc
    • stage3-ppc64le
  • s390
    • stage3-s390x
  • x86
    • stage3-x86
    • stage3-x86-hardened
    • stage3-x86-musl-vanilla
    • stage3-x86-systemd
    • stage3-x86-uclibc-hardened
    • stage3-x86-uclibc-vanilla

The following upstream stage3 targets are not built at all (see rationale⁠):

• amd64
  • stage3-amd64-hardened-selinux
  • stage3-amd64-hardened-selinux+nomultilib
  • stage3-x32
• arm
  • stage3-armv4tl
  • stage3-armv6j
  • stage3-armv7a
• ppc
  • stage3-ppc
  • stage3-ppc64
• s390
  • stage3-s390
• x86
  • stage3-i486

⁠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 /usr/portage --name myportagesnapshot gentoo/portage:latest /bin/true
docker run --interactive --tty --volumes-from myportagesnapshot gentoo/stage3-amd64: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

# image is based on stage3-amd64
FROM gentoo/stage3-amd64: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://freenode.net/#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