Factory/kiwi-builder-image/README

###########################
Kiwi SDK Image Instructions
###########################

Please ensure that you're running this on a registered SLE Micro 6.0 system, and make sure that SELinux is disabled:

# setenforce 0

Next, download the podman image:

# podman pull %%IMG_REPO%%/%%IMG_PREFIXkiwi-builder:10.1.16.0

Make a local output directory (where the images will reside):

# mkdir output

Then, to build a standard "Base" image, run the following in podman:

# podman run --privileged -v /etc/zypp/repos.d:/micro-sdk/repos/ -v ./output:/tmp/output -it %%IMG_REPO%%/%%IMG_PREFIXkiwi-builder:10.1.16.0 build-image

To build a "Base" SelfInstall ISO, you can add additional flags, for example:

# podman run --privileged -v /etc/zypp/repos.d:/micro-sdk/repos/ -v ./output:/tmp/output -it %%IMG_REPO%%/%%IMG_PREFIXkiwi-builder:10.1.16.0 build-image -p Base-SelfInstall

Then, to build a standard "Default" image, run the following in podman:

# podman run --privileged -v /etc/zypp/repos.d:/micro-sdk/repos/ -v ./output:/tmp/output -it %%IMG_REPO%%/%%IMG_PREFIXkiwi-builder:10.1.16.0 build-image -p Default

To build a "Default" SelfInstall ISO, you can add additional flags, for example:

# podman run --privileged -v /etc/zypp/repos.d:/micro-sdk/repos/ -v ./output:/tmp/output -it %%IMG_REPO%%/%%IMG_PREFIXkiwi-builder:10.1.16.0 build-image -p Default-SelfInstall

To build an image with a RealTime kernel, e.g. a RAW disk image ("Default"), use the following:

# podman run --privileged -v /etc/zypp/repos.d:/micro-sdk/repos/ -v ./output:/tmp/output -it %%IMG_REPO%%/%%IMG_PREFIXkiwi-builder:10.1.16.0 build-image -p Base-RT

To build an image that supports a large block/sectorsize (4096), use the "-b" flag, for example:

# podman run --privileged -v /etc/zypp/repos.d:/micro-sdk/repos/ -v ./output:/tmp/output -it %%IMG_REPO%%/%%IMG_PREFIXkiwi-builder:10.1.16.0 build-image -p Default-SelfInstall -b

# mkdir mydefs/
# cp /path/to/SL-Micro.kiwi mydefs/
# cp /path/to/config.sh mydefs/
# podman run --privileged -v /etc/zypp/repos.d:/micro-sdk/repos/ -v ./output:/tmp/output -v ./mydefs/:/micro-sdk/defs/ -it %%IMG_REPO%%/%%IMG_PREFIXkiwi-builder:10.1.16.0 build-image

All output will be in the local $(pwd)/output directory, for example:

# ls -1 output/
SLE-Micro.x86_64-6.0.changes
SLE-Micro.x86_64-6.0.packages
SLE-Micro.x86_64-6.0.raw
SLE-Micro.x86_64-6.0.verified
build
kiwi.result
kiwi.result.json

Note, if you want to rebuild the image, you'll need to empty the output directory, or Kiwi will error due to existing output files:

# rm -rf output/*