Skip to content

Latest commit

 

History

History
90 lines (66 loc) · 3.5 KB

README.md

File metadata and controls

90 lines (66 loc) · 3.5 KB
Raw

gitian-docker

Build Status

Build coin daemons & QT wallets with gitian in docker

Requires Docker 1.7+ installed on a build host

Host may be local iron, AWS (or other) instance, or Virtualbox VM

Currently testing has been done with:

  • Travis-CI.org

    • .travis.yml example
    • MAZA 0.10.2 will not complete if ALL steps are performed on travis as per the example above
    • travis build pulls maza/gitian-travis which is an Automated Build on Dockerhub
    • Travis caching may or may not work in the example provided
    • Builds currently succeed, with fail marks (hashes are provided, travis marks build as failed because a script commend exited non-zero)

  • Macbook Pro

    • OSX El Capitan
    • Docker 1.9.1
    • VirtualBox 5.0.14
    • Docker-Toolbox
    • build success is dependent on correct write perms
      • needs additional scripting to:
      • detect OS / Docker-Toolbox use
      • ensure that the build directory is mounted in the VM w/ correct perm/owner
      • Docker build is set to accommodate correct Vbox use

  • AWS m4.xlarge instance

    • Ubuntu 15.10
    • Docker 1.9.1
    • Builds are successful

Prebuilt Image Availability

  • images with premade base vms are created at travis-ci and pushed to docker hub (view .travis.yml)
    • use of LXC prevents this from being made on dockerhub infrastructure
  • images without premade base vms are created vi Docker hub
    • push requires use of encrpted travis variables
  • Prebuilt images are for automation & testing, and should not be relied on exclusively
  • Available images are to support automated gitian building vi travis-ci
  • MAZA is currently the only supported coin
    • more coins will be added to a build matrix as time permits
- A full daemon/QT build with dependencies will exceed the 50min time limit on open source travis-ci.org accounts - To support full automation, 2 projects (gitian-docker & main coin project) are required - users with more flexible constraints should operate without premade images

Quick Start

./build.sh [ENVFILE]

e.g.

./build.sh maza-10.2.env

To change coins, simply make a new env file with the correct variables set

## MOAR
(or, we know you like to build stuff so we'll build a builder for your builder so you can build moar)

- ./build.sh 
  sets a few variables, corrects the Dockerfiles, and runs the docker containers for you
- make_gitian_vms.sh runs in the stage1 container, and sets up the gitian build environment for you
- gitian_build.sh runs in the builder container and performs the build 
   - currently this builds win, linux, osx 

This will take the stock dockerfile and build one we'll use to build the Stage1 Container
Stage 1 container will 
 - clone a fresh copy of your source
 - get the gitian-builder
 - make the base "VMs" (LXC containers) for your gitian builds
 - copy those base-vms to your LOCAL disk
 - produce a Dockerfile for the gitian-builder container

Stage 2 Gitian-Builder container is build with your NAMESPACE (your username) 
and sets the entry point for the next script.