You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
61 lines
3.2 KiB
Markdown
61 lines
3.2 KiB
Markdown
Gitian host docker container
|
|
============================
|
|
|
|
The provided [Dockerfile](http://docs.docker.io/reference/builder/) allows to generate a [gitian-builder](https://gitian.org/) host image, that can subsequently be used for reproducible builds using LXC VMs.
|
|
|
|
How this works:
|
|
<img src="diagram.png">
|
|
|
|
Some of the discussions leading to the creation of this set of Dockerfiles/scripts are available on [this issue](https://github.com/devrandom/gitian-builder/issues/53).
|
|
|
|
Preamble
|
|
--------
|
|
|
|
It is **necessary** to read the provided scripts and understand what they do before starting to use them.
|
|
The reason is that aiming at the goal of creating a Gitian build (deterministic) also means that your build is untampered, thus trust shall be correctly attributed during the process.
|
|
|
|
For example, in this repository I provide the [Debian Archive keyring](../keyrings/debian-archive-keyring.gpg) that is used for the original debootstrap, however you **must** verify its authenticity and that it is exactly [as provided officially by Debian](https://packages.debian.org/wheezy/all/debian-archive-keyring/download)
|
|
in order to continue using a trusted chain of systems.
|
|
|
|
See also:
|
|
- https://gitian.org/
|
|
- https://en.wikipedia.org/wiki/Web_of_trust
|
|
- http://www.dwheeler.com/trusting-trust/
|
|
- https://www.debian.org/
|
|
- https://wiki.debian.org/SecureApt
|
|
- https://www.docker.io/
|
|
- http://www.ubuntu.com/
|
|
|
|
How to build the image
|
|
----------------------
|
|
Images have not been pushed to my [Docker Registry](https://index.docker.io/) account, this is on purpose because even if generated images have my repository prefix ('gdm85/') you are supposed to create them from scratch with the provided (auditable) scripts.
|
|
|
|
**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
|
|
|
|
First steps:
|
|
- run [scripts/build-wheezy.sh](../scripts/build-wheezy.sh) to get a Debian Wheezy image debootstrapped from Debian repositories.
|
|
- run [scripts/create-gitian-host.sh](../scripts/create-gitian-host.sh), this will simply build the Dockerfile that installs the few necessary dependencies inside the prepared image
|
|
- generate a second image with the i386 and amd64 VMs byu using [build-base-vms.sh](../scripts/build-base-vms.sh)
|
|
|
|
**NOTE:** when I say "run", what I really mean is "read the script, study it for your own learning purposes, then run it"
|
|
|
|
After steps above you will have prepared a full Gitian builder environment for deterministic builds.
|
|
The image that contains the VMs is called *gdm85/gitian-host-vms*; in future you can spawn containers with this image for new Gitian builder environments.
|
|
|
|
Example:
|
|
```
|
|
$ 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
|
|
$
|
|
```
|
|
This will create a privileged running container that you can access with the SSH command displayed.
|
|
|
|
Derived images
|
|
--------------
|
|
A [bitcoin gitian host container](../gitian-bitcoin-host/README.md) is available.
|
|
|
|
Credits
|
|
-------
|
|
Thanks to jpetazzo for [dind](https://github.com/jpetazzo/dind) and to #docker & bitcoin-dev IRC users for the help&assistance!
|