# make-live

## Fork
PureSAUCE fork of PureOS upstream.

https://source.puri.sm/pureos/infra/make-live

## Building a PureOS ISO image

A set of shell scripts that are used to configure the 'live-build'
tool from Debian specifically for PureOS.


    From: Matthias Klumpp <matthias.klumpp@puri.sm>
    Date: Wed, 6 Mar 2019 22:04:37 +0100
    Subject: Re: [PureOS] Building my own PureOS ISO image?
    Message-ID: <CAKNHny8ZXyzAD6fCa0WS2wDs_bxQcO0oKyFns3Q022yuCVkDKw@mail.gmail.com>

    > [..]

    That should be pretty easy. The basic process is the following (see
    below for replicating almost 100% of what our builders do):

    1) Create a PureOS green chroot (just debootstrap green and chroot into PureOS)
    1.1) /!\ All following steps happen inside of the PureOS chroot
    2) Run `apt install live-build git ca-certificates`
    3) cd /srv && git clone https://source.puri.sm/pureos/infra/make-live.git
    4) cd /srv/make-live
    5) Set the FLAVOR environment variable to what flavor of PureOS you
    want to build. Possible values are:
        * gnome-live
        * gnome-oem
        * plasma-live
       E.g. `export FLAVOR="gnome-oem"`.
       If no FLAVOR variable is set, the GNOME Live Flavor will be built by default
    6) Run `lb config`
    7) Run `lb build`
    8) Have fun with a fresh new PureOS image!

    These steps can be sped up a lot and be automated by using debspawn,
    which is used to create the official PureOS images in a controlled
    environment.
    In order to use debspawn, just follow these steps:
    1) Run `sudo apt install debspawn`
    2) Then run `debspawn create green`
    3) Create a new "build-pureos.sh" file with the following contents:
    ```
    #!/bin/sh
    set -e
    set -x

    export FLAVOR="gnome-live"
    export DEBIAN_FRONTEND=noninteractive
    apt-get install -y git ca-certificates
    apt-get install -y live-build

    git clone --depth=2 https://source.puri.sm/pureos/infra/make-live.git
    /srv/build/lb
    cd /srv/build/lb/

    lb config
    lb build

    b2sum *.iso *.contents *.zsync *.packages > checksums.b2sum
    sha256sum *.iso *.contents *.zsync *.packages > checksums.sha256sum
    mv *.iso /srv/artifacts
    mv -f *.zsync /srv/artifacts
    mv -f *.contents /srv/artifacts
    mv -f *.files /srv/artifacts
    mv -f *.packages /srv/artifacts
    mv -f *.b2sum /srv/artifacts
    mv -f *.sha256sum /srv/artifacts
    ```
    4) Make the .sh file executable and set the FLAVOR you want.
    5) Tell debspawn to run the build and where to place the build result:
    `debspawn run --external-command
    --artifacts-out=/where/to/put/the/built/image green
    /path/to/build-pureos.sh`

    This should give you a replica of what our autobuilders did. You can
    also take a look at the actual code in Spark:
    https://github.com/lkorigin/laniakea-spark/blob/master/spark/runners/image_build.py#L30