History

Yolanda Robla 7ed343ce32 Add script to validate fedora atomic images Initially do a qemu-img check to ensure that the image is valid, and also check that the image size is the one we expect. Change-Id: I447372df99303f40fd033b9673ec6cc370e65477		2016-04-21 14:57:11 +02:00
..
environment.d	Generate fedora-atomic images using dib	2016-03-30 14:37:40 -04:00
finalise.d	Generate fedora-atomic images using dib	2016-03-30 14:37:40 -04:00
README.rst	Generate fedora-atomic images using dib	2016-03-30 14:37:40 -04:00
element-deps	Generate fedora-atomic images using dib	2016-03-30 14:37:40 -04:00
install_imagebuild_deps.sh	Add script to install image build dependencies	2016-04-11 21:55:03 +02:00
package-installs.yaml	Generate fedora-atomic images using dib	2016-03-30 14:37:40 -04:00
validate_atomic_image.sh	Add script to validate fedora atomic images	2016-04-21 14:57:11 +02:00

README.rst

fedora-atomic

Generates a Fedora Atomic image based on a public deployed tree. This element has been tested under Debian, Ubuntu, CentOS and Fedora operating systems.

Pre-requisites to run diskimage-builder

For diskimage-builder to work, following packages need to be present:

python-dev
build-essential
python-pip
kpartx
python-lzma
qemu-utils
yum
yum-utils
python-yaml

For Debian/Ubuntu systems, use:

apt-get install python-dev build-essential python-pip kpartx python-lzma qemu-utils yum yum-utils python-yaml

For CentOS and Fedora < 22, use:

yum install python-dev build-essential python-pip kpartx python-lzma qemu-utils yum yum-utils python-yaml

For Fedora >= 22, use:

dnf install python-dev build-essential python-pip kpartx python-lzma qemu-utils yum yum-utils python-yaml

diskimage-builder can be installed using pip:

pip install diskimage-builder

How to generate Fedora Atomic image

To generate an atomic image for Fedora 23 these commands can be executed:

export ELEMENTS_PATH=/path/to/diskimage-builder/elements:/path/to/magnum/elements
export DIB_RELEASE=23     # this can be switched to the desired version
export DIB_IMAGE_SIZE=2   # we need to give a bit more space to loopback device
disk-image-create fedora-atomic

This element can consume already published trees, but you can use it to consume your own generated trees. Documentation about creating own trees can be found at http://developers.redhat.com/blog/2015/01/08/creating-custom-atomic-trees-images-and-installers-part-1/

Environment Variables

To properly reference the tree, the following env vars can be set:

FEDORA_ATOMIC_TREE_URL

Required: Yes
Description: Url for the public fedora-atomic tree to use. It can reference to own published trees.
Default: https://dl.fedoraproject.org/pub/fedora/linux/atomic/23/

FEDORA_ATOMIC_TREE_REF

Required: Yes
Description: Reference of the tree to install.
Default: 954bdbeebebfa87b625d9d7bd78c81400bdd6756fcc3205987970af4b64eb678