tenku/docker/gitian-host/README.md
gdm85 3491c6646e * completed documentation
* added prefix to image tags
2015-01-14 10:48:06 +01:00

39 lines
1.6 KiB
Markdown

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!