Page MenuHomePhabricator

Add information to setup a VM to do gitian build manually

Authored by deadalnix on Jan 11 2019, 15:58.


Group Reviewers
Restricted Project
rABC00e19b839fa0: Add information to setup a VM to do gitian build manually

This ports the documentation from and adapt them to fit Bitcoin ABC.

Link to sections of are now dead as this docmentation was removed from Bitcoin ABC.

Test Plan

I was able to:

  • follow the instruction and create a Debian VM.
  • run the manual gitian build on said VM.
  • run the offline gitian build on that VM.

I was unable to:

  • Verifiy the vagrant documentation
  • Verify that works as advertised
  • Create a Fedora VM

Diff Detail

rABC Bitcoin ABC
Automatic diff as part of commit; lint not applicable.
Automatic diff as part of commit; unit tests not applicable.

Event Timeline

deadalnix created this revision.Jan 11 2019, 15:58
Herald added a reviewer: Restricted Project. · View Herald TranscriptJan 11 2019, 15:58
Herald added a subscriber: schancel. · View Herald Transcript
Fabien requested changes to this revision.Jan 14 2019, 11:28
Fabien added a subscriber: Fabien.

What I tried:

  • follow the instruction and create a Debian VM => OK
  • run the offline gitian build on said VM => OK
  • run the script => did not work

The script is trying to setup an Ubuntu Bionic VM using Debootstrap scripts, but the Debootstrap version shipped with Debian 9 is too old and does not know about Ubuntu Bionic.

Note: the contrib/gitian-descriptors/gitian-*-signer.yml should be updated or removed as they seem to not have been updated from core

35 ↗(On Diff #6624)

Xcode_7.3.1.dmg is no longer needed:
rm -rf 5.hfs MacOSX10.11.sdk Xcode_7.3.1.dmg

84 ↗(On Diff #6624)

If the user is strictly following the instructions, the path is know:

export PATH="$PATH":/home/gitianuser/gitian-builder/libexec
export USE_LXC=1
cd ~/gitian-builder

This will help copy and paste the lines

100 ↗(On Diff #6624)


sudo sed -i 's/# Offlinemode: 0/Offlinemode: 1/g' /etc/apt-cacher-ng/acng.conf
sudo service apt-cacher-ng restart
111 ↗(On Diff #6624)

Update to:

COMMIT=<commmit hash or tag>
./bin/gbuild --commit bitcoin=${COMMIT} --url bitcoin=${URL} ../bitcoin-abc/contrib/gitian-descriptors/gitian-win.yml
This revision now requires changes to proceed.Jan 14 2019, 11:28
deadalnix added inline comments.Jan 14 2019, 22:49
35 ↗(On Diff #6624)

Because it wasn't specified how and where to get it from, I don't think we should specify how to delete it. The doc never took ownership of that file.

100 ↗(On Diff #6624)

I don't think we should use sed here, as someone might want to toggle this n a way that do not fit the pattern.

deadalnix updated this revision to Diff 6660.Jan 14 2019, 23:43

Update doc to reflect comments

Fabien added inline comments.Jan 15 2019, 08:30
35 ↗(On Diff #6624)

The file name is somewhat specified from the direct download link, and the same remove instruction is given in the MacOS host section.
This would not be a big concern if the file was not 5GB !

deadalnix added inline comments.Jan 19 2019, 01:43
35 ↗(On Diff #6624)

This doesn't change that this doc hasn't took ownership of the file.

Fabien accepted this revision.Jan 28 2019, 17:58

As discussed in the dev meeting, at least some instructions have been tested successfully.
The remaining part can be tested/fixed in later diffs.

This revision is now accepted and ready to land.Jan 28 2019, 17:58
This revision was automatically updated to reflect the committed changes.