overlay/Linux/usr/local/src/ansible_gentooimgr

README.md

@@ -58,10 +58,19 @@ You must set these variable in a host in hosts.yml in the linux_chroot_group:
           BOX_NBD_MP: /mnt/gentoo
           BOX_NBD_FILES: "/i/data/Agile/tmp/Topics/GentooImgr"
           BOX_NBD_BASE_QCOW: "/g/Agile/tmp/Topics/GentooImgr/gentoo.qcow2"
+This role is slow and may take an hour or more;
 It will build the BOX_NBD_BASE_QCOW.
 
-2) We build the qcow2 overlay image that we can maintain by libvirt.
+As a safety feature you must create and open the qcow base image before
+running the roles: the roles do not use qemu-nbd -c or qemu-nbd -d by
+design. You may also choose to download the gentoo latest stage3 and
+portage files to the directory specified in hosts.ynl as BOX_NBD_FILES
+These
 
+2) We build the qcow2 overlay image that we can maintain by libvirt.
+It is run on the host by the build_overlay Makefile target which runs
+/usr/local/bin/toxcore_build_overlay_qcow.bash. It gets its parameters from
+the hosts.yml file from the host called gentoo1 in the linux_libvirt_group.
 
 ## Roles
 
@@ -144,6 +153,8 @@ On Ansibles from 2.10 and later, you will need the community plugins installed.
 
 ### ansible_local.bash
 
+We have a script that calls ansible to run our play: ansible_local.yml
+
 [ -l limit ]
 [ -c connection ]
 [ --skip comma,separated]