summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--README.md40
1 files changed, 19 insertions, 21 deletions
diff --git a/README.md b/README.md
index dbc93cd..a2fb529 100644
--- a/README.md
+++ b/README.md
@@ -1,30 +1,28 @@
# Ansible roles for OpenSLX
-Small collection of ansible roles to build a dracut-based initramfs for network boot.
-The roles currently support both Ubuntu 16.04.2 and CentOS 7.3.
-Currently, it only matches these distribution families but does not check for these exact versions!
+Small collection of ansible roles to build a dracut-based initramfs for network boot via dnbd3.
+Currently up-to-date versions of Ubuntu and CentOS are supported (version 18.04.1 and 7.5.1804, respectively).
-### setup-dev-tools
-Installs basic development packages for the detected distribution:
-
- Ubuntu: build-essential, cmake, git
- CentOS: "@development tools", cmake, git
+The provided 'slx-builder.yml' playbook can be used, e.g. as an ansible provisioner in a packer template.
+## Included roles
-### dracut-initramfs-builder
+### slx-builder
Builds the dracut-based initramfs using the dnbd3-rootfs module (see [systemd-init](http://git.openslx.org/openslx-ng/systemd-init.git/)):
-* Install needed dependencies to build dracut for the detected distribution
+* Install needed build dependencies for the detected distribution
* Checkout git repository for systemd-init
-* Build the initramfs for the running kernel
-* Extract both initramfs and kernel out of the virtual machine
+* Build the initramfs using the 'build-initramfs.sh' script
+* Extracts both initramfs and kernel to the subdirectory 'boot_files'
+* Cleans up the systemd-init repository
+
+This role is tagged to separate between the initialization of the required dependencies ('install' tag) and the build of the initramfs ('build' tag).
-Depends on *setup-dev-tools* role (see dracut-initramfs-builder/meta/main.yml).
+Depends on *setup-dev-tools* role (specified in slx-builder/meta/main.yml).
-## Usage
-Use the provided 'build-dracut-initramfs.yml' playbook for the ansible provisioner in your packer template.
-You can use an already created qcow2 image, instead of always generating new packer images. See *run-playbook-only.json*
-for a sample packer template to use an existing qcow2 image and provision them with our playbook.
-The template requires the variable 'image_path' to be set, which needs to be the path of the qcow2 image.
+### setup-dev-tools
+Installs basic development packages for the detected distribution:
+
+ Ubuntu: build-essential, cmake, git
+ CentOS: "@development tools", cmake, git
-If it was generated by packer and the manifest was created, you can simply extract the image path from that:
- # Be in same directory as where you built the image with packer with an ansible-roles in that directory, then:
- packer build -var-file=base.json -only=qemu -var='image_path='"$(jq -r '.builds[0].files[0].name' < manifest.json)"'' ansible-roles/run-playbook-only.json
+### disable-selinux
+Disables SELinux. This is included on CentOS systems to be able to boot from the generated initramfs.