search

awesomebytes / gentoo_prefix_ci

A Gentoo Prefix continuous integration repo. Find precompiled Gentoo Prefix in the releases section
BSD 2-Clause "Simplified" License
14 stars 4 forks source link

readme

gentoo_prefix_ci

Build Status

A Gentoo Prefix continuous integration repo.

Bootstrapping Gentoo Prefix every night on /tmp/gentoo for amd64 over a Docker image of Ubuntu 16.04.

Builds page (with results and shell outputs): https://dev.azure.com/12719821/12719821/_build?definitionId=2

Ready-to-use releases (with instructions): https://github.com/awesomebytes/gentoo_prefix_ci/releases

Ready-to-use built docker image: docker pull awesomebytes/gentoo_prefix_latest_image_package_stage

Try Gentoo Prefix

Go to https://github.com/awesomebytes/gentoo_prefix_ci/releases and download the latest release (700MB~).

Extract (2.2GB~):

tar xvf gentoo_on_tmp*.tar.lzma

Run your prefix shell by doing:

./gentoo/startprefix

Or use Docker:

docker pull awesomebytes/gentoo_prefix_boostrapped
docker run -it awesomebytes/gentoo_prefix_boostrapped /bin/bash
./tmp/gentoo/startprefix

What do you mean continuous integration?

Every night (00:00) Sydney time (GMT +10h) the Azure pipelines build farm will bootstrap a Gentoo Prefix by using the configuration found in this repo. (Takes 7h~).

azure-pipelines.yaml defines what jobs run. Every job pushes a docker image to awesomebytes DockerHub with the end of the job status. Right now the build is divided in 3 steps (check the corresponding Dockerfile to see the commands executed):

  1. Dockerfile.prepare. Prepares an image with the minimal requirements to build and debug the bootstrap. DockerHub image
  2. Dockerfile.stage1. Bootstraps stage 1. DockerHub image
  3. Dockerfile.stage2. Bootstraps stage 2. DockerHub image
  4. Dockerfile.stage3. Bootstraps stage 3. DockerHub image
  5. Dockerfile.emergesystem. Does emerge -e system after stage 3 to finish bootstrapping the system. DockerHub image

You can use any of those images (intermediate ones to debug, or the final one to play with Gentoo Prefix). Just do:

# To try Gentoo Prefix already bootstrapped in Docker over Ubuntu 16.04 in /tmp/gentoo
docker pull awesomebytes/gentoo_prefix_boostrapped
docker run -it awesomebytes/gentoo_prefix_boostrapped

Why Azure pipelines?

They offer free build pipelines for opensource projects with up to 10 parallel builds. Every job can run for up to 6 hours and there is no limit in monthly minutes.

The machines have specs similar to:

Just, why?

Gentoo Prefix is an awesome framework to deploy (almost) any software in any machine where you have no privileges. Just read the awesome use-cases article. I found myself unable to bootstrap the image and neither find an already bootstrapped image. So I built this.

Acknowledgements

Thanks to the people in the #gentoo-prefix IRC channel, to the Gentoo-Alt mailing list, and in general to anyone that helped me while building all this.