github.com/tdcblockchain/tdcblockchain@v0.0.0-20191111034745-805c65ade158/build/ci-notes.md (about) 1 # Debian Packaging 2 3 Tagged releases and develop branch commits are available as installable Debian packages 4 for Ubuntu. Packages are built for the all Ubuntu versions which are supported by 5 Canonical. 6 7 Packages of develop branch commits have suffix -unstable and cannot be installed alongside 8 the stable version. Switching between release streams requires user intervention. 9 10 ## Launchpad 11 12 The packages are built and served by launchpad.net. We generate a Debian source package 13 for each distribution and upload it. Their builder picks up the source package, builds it 14 and installs the new version into the PPA repository. Launchpad requires a valid signature 15 by a team member for source package uploads. 16 17 The signing key is stored in an environment variable which Travis CI makes available to 18 certain builds. Since Travis CI doesn't support FTP, SFTP is used to transfer the 19 packages. To set this up yourself, you need to create a Launchpad user and add a GPG key 20 and SSH key to it. Then encode both keys as base64 and configure 'secret' environment 21 variables `PPA_SIGNING_KEY` and `PPA_SSH_KEY` on Travis. 22 23 We want to build go-ethereum with the most recent version of Go, irrespective of the Go 24 version that is available in the main Ubuntu repository. In order to make this possible, 25 our PPA depends on the ~gophers/ubuntu/archive PPA. Our source package build-depends on 26 golang-1.11, which is co-installable alongside the regular golang package. PPA dependencies 27 can be edited at https://launchpad.net/%7Eethereum/+archive/ubuntu/ethereum/+edit-dependencies 28 29 ## Building Packages Locally (for testing) 30 31 You need to run Ubuntu to do test packaging. 32 33 Add the gophers PPA and install Go 1.11 and Debian packaging tools: 34 35 $ sudo apt-add-repository ppa:gophers/ubuntu/archive 36 $ sudo apt-get update 37 $ sudo apt-get install build-essential golang-1.11 devscripts debhelper python-bzrlib python-paramiko 38 39 Create the source packages: 40 41 $ go run build/ci.go debsrc -workdir dist 42 43 Then go into the source package directory for your running distribution and build the package: 44 45 $ cd dist/ethereum-unstable-1.6.0+xenial 46 $ dpkg-buildpackage 47 48 Built packages are placed in the dist/ directory. 49 50 $ cd .. 51 $ dpkg-deb -c geth-unstable_1.6.0+xenial_amd64.deb