[libvirt] [jenkins-ci PATCH v2] guests: add more detailed docs on deploying FreeBSD

[Daniel P. Berrangé]

Provide instructions on how to download & deploy a working FreeBSD
install that's suitable for CI, as there are several gotchas not
mentioned in the current docs.

Signed-off-by: Daniel P. Berrangé <berrange at redhat.com>
---
 guests/README.markdown | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/guests/README.markdown b/guests/README.markdown
index 7e63540..d450b4a 100644
--- a/guests/README.markdown
+++ b/guests/README.markdown
@@ -137,6 +137,37 @@ FreeBSD
 Installation of FreeBSD guests must be performed manually; alternatively,
 the official qcow2 images can be used to quickly bring up such guests.
 
+  $ MAJOR=12
+  $ MINOR=1
+  $ VER=$MAJOR.$MINOR-RELEASE
+  $ sudo wget -O /var/lib/libvirt/images/libvirt-freebsd-$MAJOR.qcow2.xz \
+      https://download.freebsd.org/ftp/releases/VM-IMAGES/$VER/amd64/Latest/FreeBSD-$VER-amd64.qcow2.xz
+  $ sudo unxz /var/lib/libvirt/images/libvirt-freebsd-$MAJOR.qcow2.xz
+  $ sudo virt-install \
+      --import \
+      --name libvirt-freebsd-$MAJOR \
+      --vcpus 2 \
+      --graphics vnc \
+      --noautoconsole \
+      --console pty \
+      --sound none \
+      --rng device=/dev/urandom,model=virtio \
+      --memory 2048 \
+      --os-variant freebsd$MAJOR.0 \
+      --disk /var/lib/libvirt/images/libvirt-freebsd-$MAJOR.qcow2
+
+The default qcow2 images are sized too small to be usable. To enlarge
+them do
+
+ $ sudo virsh blockresize libvirt-freebsd-$MAJOR \
+     /var/lib/libvirt/images/libvirt-freebsd-$MAJOR.qcow2 20G
+
+Then inside the guest, as root, enlarge the 3rd partition & filesystem
+to consume all new space:
+
+ # gpart resize -i 3 vtbd0
+ # service growfs onestart
+
 Some manual tweaking will be needed, in particular:
 
 * `/etc/ssh/sshd_config` must contain the `PermitRootLogin yes` directive;
-- 
2.23.0