* completed documentation

* added prefix to image tags

docker/gitian-host/Dockerfile

@@ -3,12 +3,12 @@
 ## VERSION 0.1.0
 ##
 ## gitian host privileged container
-## see also https://github.com/gdm85/tenku/tree/master/docker/gitian-builder-host.md
+## see also https://github.com/gdm85/tenku/tree/master/docker/gitian-host/README.md
 ##
 #
 
 ## this image must be debootstrapped with build-wheezy.sh
-FROM wheezy
+FROM gdm85/wheezy
 
 MAINTAINER Giuseppe Mazzotta "gdm85@users.noreply.github.com"
 

docker/gitian-host/README.md

@@ -0,0 +1,38 @@
+What is this?
+=============
+
+A [Dockerfile](http://docs.docker.io/reference/builder/) to generate a [gitian-builder](https://gitian.org/) host image, that can subsequently be used for reproducible builds using LXC VMs.
+
+It goes like this:
+```<your real host> -> docker -> gitian-host container -> <LXC containers to perform gbuilds>```
+
+Yes, it's a bit of an inception.
+
+See also https://github.com/devrandom/gitian-builder/issues/53
+
+How to build the image
+----------------------
+
+I have not yet pushed images to the [Docker Registry](https://index.docker.io/), but it is a non-issue because you are supposed to create your images from scratch.
+
+First run **scripts/build-wheezy.sh** to get a Debian Wheezy image debootstrapped from Debian repositories.
+
+**NOTE:** you must have debootstrap on your real host to run this script successfully, and also make sure you have a keyring with APT keys, see also https://wiki.debian.org/SecureApt
+
+At this point run **scripts/create-gitian-host.sh**, if all goes well then you can spawn a gitian-builder container as follows:
+
+```
+$ scripts/spawn-gitian-host.sh
+You can now SSH into container 8a955ff5607b62d4c295745f27bbc38f2e8e011ea93053e641617d50ad2aa5a2:
+ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no debian@172.17.0.2
+$ 
+```
+
+**NOTE:** when I say "run", what I really mean is "read the script, study it for your own learning purposes, then run it" ;)
+
+This will create a privileged container that you can access with the SSH command displayed
+
+Credits
+-------
+
+Thanks to jpetazzo for [dind](https://github.com/jpetazzo/dind) and to the vibrant Docker community for the help&assistance!

docker/scripts/build-wheezy.sh

@@ -26,7 +26,7 @@ TMPDIR=$PWD/$DISTNAME
 
 debootstrap $DISTNAME $DISTNAME $DEBIAN_REPO && \
 cd $DISTNAME && \
-tar -c . | docker import - $DISTNAME
+tar -c . | docker import - gdm85/$DISTNAME
 RV=$?
 
 # always perform cleanup