From e866286a4411138c49e329b7e71f67d9b187edba Mon Sep 17 00:00:00 2001
From: Jonathan Bauer
Date: Fri, 10 Mar 2017 18:37:04 +0100
Subject: Templates for Centos 7.3 and Ubuntu 16.04

These were tested with qemu (2.8.0), virtualbox (5.1.16) and vmplayer
(12.5.2-4638234). Using the qemu builder is preferable as it creates
a qcow2 file directly.
The unattended install is configured to install the necessary packages
for ansible which will be needed to provision the VM. The rest is still
pretty minimal.
---
 README.md | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

(limited to 'README.md')

diff --git a/README.md b/README.md
index 26436d9..60d5011 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,35 @@
 # Packer templates for OpenSLX
 
-TODO 
+Packer-based generation of reference systems using distro's ISOs.
+
+## Dependencies
+
+Packer => 0.12.2
+Download: https://www.packer.io/downloads.html
+
+## Usage
+
+The file 'base.json' contains default variables (VM, SSH) common to all templates.
+Thus it should always be included using packer's '-var-file' option.
+
+Basic usage:
+	packer build -var-file=base.json <template>
+
+Example: build Ubuntu 16.04.2 LTS template using qemu builder
+	packer build -var-file=base.json -only=qemu ubuntu-16.04-amd64.json
+
+Debug:
+	PACKER_LOG=1 PACKER_LOG_FILE=/var/log/packer.log \
+		packer build -debug -only=qemu -var-file=base.json ubuntu-16.04-amd64.json
+
+## Notes
+
+Variables set in base.json can be overriden using packer's '-var' options, e.g.:
+	packer build -var-file=base.json -var='headless=true' <template>
+
+(Make sure you first include base.json before overriding a variable!)
+
+Packer connects to the VM per SSH to provision them after the initial iso installation.
+A default password is defined in base.json and the corresponding SHA-512 hashes are set
+in the kickstart/preseed files. If you change the 'ssh_password' make sure to change the
+hashes in the ks/ps files (generate with 'mkpasswd -m sha-512')!
-- 
cgit v1.2.3-55-g7522