Sabayon Reload Scripts

Build Sabayon from scratch with Ansible and Docker for:

• check periodically if all sabayon-distro and for-gentoo overlay works correctly

• simplify process for create a custom Sabayon Distro with different USE flags

• simplify process for manage local repository

NOTE: It's under development. Not completed.

It is based on Sabayon Dockerfile written by mudler and Sabayon Team.

Requirements

• Docker
• LXD
• Ansible-2.4 (2.5 is not yet supported).

Process steps

For now only for amd64 platform.

1. stage3-gentoo-systemd-amd64

From Gentoo Stage3 tarball is created a docker image after update portage, rebuild @world and remove some unneeded packages.

Ansible tag for this image is amd64,amd64_gentoo_stage3.

2. stage3-sabayon-amd64

From stage3-gentoo-systemd-amd64 is installed equo and entropy.

Ansible tag for this image is amd64,amd64_sabayon_stage3.

3. sabayon-base-amd64

From stage3-sabayon-amd64 is configure sabayon repository and sync with last packages version.

Ansible tag for this image is amd64,amd64_sabayon_base.

4. sabayon-spinbase-amd64

The purpose of this image is to provide an image of a Sabayon base with upgrades and tools, ready to be shipped on VM(s)/LiveCDs.

Ansible tag for this image is amd64,amd64_sabayon_spinbase.

5. sabayon-builder-amd64

The purpose of this project is to provide an image of Sabayon docker-capable builder. It is just a Sabayon base with upgrades and compilation tools.

For complete documentation see Sabayon/docker-builder-amd64 page.

Ansible tag for this image is amd64,amd64_sabayon_builder.

Images Tree

gentoo-stage3 (systemd profile)
     |
     |
     +--> sabayon-stage3 ------> sabayon-base  ----> sabayon-spinbase --> sabayon-builder
     |                              |
     |                               \-> sabayon-check-overlay
     |
     \
      \-> sabayon-stage3-reload -> sabayon-create-repo ===> sabayon-base-reload ---> sabayon-rebuilder

Build Images

Under ansible directory, for build step 1:

  $# ansible-playbook --tags amd64_gentoo_stage3 build.yml

For build step 2:

  $# ansible-playbook --tags amd64_sabayon_stage3 build.yml

For build step 3:

  $# ansible-playbook --tags amd64_sabayon_base build.yml

For build step 4:

  $# ansible-playbook --tags amd64_sabayon_spinbase build.yml

For build step 5:

  $# ansible-playbook --tags amd64_sabayon_builder build.yml

For build all AMD64 docker images:

  $# ansible-playbook --tags amd64

For build all:

  $# ansible-playbook build.yml

ARM7 Stages

I begin integration of some Docker stage for ARMv7 (32bit) but is under development.

Build ISO images

Through iso_build.yml playbook is possible create Sabayon ISO images and do changes through environment variables.

  $# ansible-playbook iso_build.yml

About what ISO you can build and add custom packages to images or custom repository see sabayon-molecules documentation.

Customize Build Process

Current ansible configuration permit build process on localhost but it is possible configure Ansible to build images to a remote machine. See Ansible documentation for details.

In particular, under localhost host variable file it is possible customize these options:

Option	Default	Description
builder_rootdir	..	Path of the sabayon-reload project tree.
docker_user	geaaru	Name of the user used for create docker images
gentoo_dist_server	http://distfiles.gentoo.org/	URL where retrieve portage tarball and gentoo stage3 file.
gentoo_skip_sync	1	Execute portage sync before build process (1) or not (0).
sabayon_skip_sync	1	Execute equo update before install packages (1) or not (0).
staging_dir	./staging	Directory used by sabayon-lxd-imagebuilder for convert docker image, etc.
lxd_target_server	local	Target LXD Server where upload images
lxd_skip_pull	1	Skip pull from docker image on create LXD images (1) or not (0). Normally, is set to 1 when images are created locally.
docker_build_custom_opts	--force-rm --squash --rm	Additional option for docker build phases. By default use --squash that require experimental feature on Docker.
molecules_git_url	https://github.com/geaaru/molecules.git	Git URL of Sabayon molecule repository
molecules_version	scripts-review	Branch or Tag to use.
molecules_docker_src_image	sabayon/spinbase-amd64:latest	Define Docker image used as base for build Sabayon ISO
docker_run_custom_opts	-	Define custom option to docker run command.
molecules_opts	-	Define option for iso_build.sh script for ISO building phase.
molecules_iso_volume	/tmp/iso	Define path where docker image store ISO images created
molecules_envfile	-	Permit to define custom Environment file for ISO building for override default options
molecules_docker_src_image	sabayon/spinbase-amd64:latest	If available permit to define source image for ISO building
molecules_kernel_version	-	Define kernel slot to install on Sabayon ISO image
molecules_extra_pkgs	-	Define a list of additional packages to install on ISO images
molecules_enman_repos	-	Define a list of enman repositories to add on creation of ISO images
molecules_unmask_pkgs	-	Define a list of packages to unmask on creation of ISO images

Test Suites

To permit a continuos delivery of the images and verify that all works fine there are different playbooks to convert docker images of different tecnologies. Currently, it is supported LXD.

For test docker image on LXD images (or with same tags for test customized test): ²

  $# ansible-playbook lxd.yml -K

This playbook create also LXD images related to every steps on configured LXD server and require root permission (or sudo password with -K option).

Create a fresh container from Docker Image

It is possible use playbook to simplify creation of a container with last image produced with this command:

  $# ansible-playbook lxd.yml -K --tags amd64_sabayon_spinbase --skip-tags skip_del_container -e container_name="my-container"

This create a new container with name "my-container" from sabayon_spinbase image.

For list of all tags:

  $# ansible-playbook lxd.yml --list-tags