diff --git a/contrib/gitian-descriptors/README.md b/contrib/gitian-descriptors/README.md index 3a90b4d03..78abea012 100644 --- a/contrib/gitian-descriptors/README.md +++ b/contrib/gitian-descriptors/README.md @@ -1,64 +1,8 @@ -### Gavin's notes on getting gitian builds up and running using KVM:### - -These instructions distilled from: -[ https://help.ubuntu.com/community/KVM/Installation]( https://help.ubuntu.com/community/KVM/Installation) -... see there for complete details. - -You need the right hardware: you need a 64-bit-capable CPU with hardware virtualization support (Intel VT-x or AMD-V). Not all modern CPUs support hardware virtualization. - -You probably need to enable hardware virtualization in your machine's BIOS. - -You need to be running a recent version of 64-bit-Ubuntu, and you need to install several prerequisites: - - sudo apt-get install ruby apache2 git apt-cacher-ng python-vm-builder qemu-kvm - -Sanity checks: - - sudo service apt-cacher-ng status # Should return apt-cacher-ng is running - ls -l /dev/kvm # Should show a /dev/kvm device - - -Once you've got the right hardware and software: - - git clone git://github.com/bitcoin/bitcoin.git - git clone git://github.com/devrandom/gitian-builder.git - mkdir gitian-builder/inputs - cd gitian-builder/inputs - - # Get inputs (see doc/release-process.md for exact inputs needed and where to get them) - ... - cd ../.. - - cd gitian-builder - bin/make-base-vm --arch i386 - bin/make-base-vm --arch amd64 - cd .. - - # Build Linux release: - cd bitcoin - git pull - cd ../gitian-builder - git pull - ./bin/gbuild --commit bitcoin=HEAD ../bitcoin/contrib/gitian-descriptors/gitian-linux.yml - - # Build Win32 dependencies: (only needs to be done once, or when dependency versions change) - ./bin/gbuild --commit bitcoin=HEAD ../bitcoin/contrib/gitian-descriptors/boost-win32.yml - ./bin/gbuild --commit bitcoin=HEAD ../bitcoin/contrib/gitian-descriptors/deps-win32.yml - ./bin/gbuild --commit bitcoin=HEAD ../bitcoin/contrib/gitian-descriptors/qt-win32.yml - ./bin/gbuild --commit bitcoin=HEAD ../bitcoin/contrib/gitian-descriptors/protobuf-win32.yml - - # Build Win32 release: - ./bin/gbuild --commit bitcoin=HEAD ../bitcoin/contrib/gitian-descriptors/gitian-win32.yml - ---------------------- - -`gitian-builder` now also supports building using LXC. See -[ https://help.ubuntu.com/12.04/serverguide/lxc.html]( https://help.ubuntu.com/12.04/serverguide/lxc.html) -... for how to get LXC up and running under Ubuntu. +### Setting up Gitian on a VM using LXC ### If your main machine is a 64-bit Mac or PC with a few gigabytes of memory and at least 10 gigabytes of free disk space, you can `gitian-build` using -LXC running inside a virtual machine. +LXC running inside a virtual machine (VirtualBox, VMware, probably others too). Here's a description of Gavin's setup on OSX 10.6: @@ -67,14 +11,38 @@ Here's a description of Gavin's setup on OSX 10.6: 2. Download the 64-bit Ubuntu Desktop 12.04 LTS .iso CD image from [http://www.ubuntu.com/](http://www.ubuntu.com/) -3. Run VirtualBox and create a new virtual machine, using the Ubuntu .iso (see the [VirtualBox documentation](https://www.virtualbox.org/wiki/Documentation) for details). Create it with at least 2 gigabytes of memory and a disk that is at least 20 gigabytes big. +3. Run VirtualBox and create a new virtual machine, using the Ubuntu .iso (see the [VirtualBox documentation](https://www.virtualbox.org/wiki/Documentation) for details). Create it with at least 2 gigabytes of memory and a disk that is at least 50 gigabytes big. 4. Inside the running Ubuntu desktop, install: sudo apt-get install debootstrap lxc ruby apache2 git apt-cacher-ng python-vm-builder -5. Still inside Ubuntu, tell gitian-builder to use LXC, then follow the "Once you've got the right hardware and software" instructions above: +5. Still inside Ubuntu, tell gitian-builder to use LXC, then follow the instructions below: export USE_LXC=1 - git clone git://github.com/bitcoin/bitcoin.git - ... etc + +------------------------------------------------------------------------- + +Sanity check: + + sudo service apt-cacher-ng status # Should return apt-cacher-ng is running + +Enable bridging interface for networking: + + sudo brctl addbr br0 + sudo ifconfig br0 10.0.2.2/24 up + +Once you've got the right hardware and software: + + git clone git://github.com/dogecoin/dogecoin.git + git clone git://github.com/devrandom/gitian-builder.git + +Prepeare the builder VMs: + + cd gitian-builder + bin/make-base-vm --arch i386 + bin/make-base-vm --arch amd64 + cd .. + +Now follow the build process under doc/release-process to first build the dependecies +(one time task, or when the dependencies change) and then the client packagaes. \ No newline at end of file