summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorJonathan Bauer2017-03-17 16:56:55 +0100
committerJonathan Bauer2017-03-17 16:56:55 +0100
commitb5516c8ff47ed02e50821644f788adc14c19ab1c (patch)
tree5ad0d9b69d8f9c8b600a648b8811e2cd9725e45e /README.md
parentinitial commit (diff)
downloadansible-dracut-b5516c8ff47ed02e50821644f788adc14c19ab1c.tar.gz
ansible-dracut-b5516c8ff47ed02e50821644f788adc14c19ab1c.tar.xz
ansible-dracut-b5516c8ff47ed02e50821644f788adc14c19ab1c.zip
added basic roles to generate stage3 initramfs
Diffstat (limited to 'README.md')
-rw-r--r--README.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/README.md b/README.md
index 8768b09..ede4cdc 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,22 @@
# 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!
+### setup-dev-tools
+Installs basic development packages for the detected distribution:
+
+ Ubuntu: build-essential, cmake, git
+ CentOS: "@development tools", cmake, git
+
+### dracut-initramfs-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
+* Checkout git repository for systemd-init
+* Build the initramfs for the running kernel
+* Extract both initramfs and kernel out of the virtual machine
+
+Depends on *setup-dev-tools* role (see dracut-initramfs-builder/meta/main.yml).
+
+## Usage
+Use the provided 'build-dracut-initramfs.yml' playbook for the ansible provisioner in your packer template.