aboutsummaryrefslogtreecommitdiffstats
path: root/build/ci-notes.md
diff options
context:
space:
mode:
authorFelix Lange <fjl@twurst.com>2016-10-01 04:03:08 +0800
committerFelix Lange <fjl@twurst.com>2016-10-02 19:08:56 +0800
commit4f7627972e4997965be6f3c406904ef613e14c20 (patch)
tree0d4e7f9ce56a2d161aa8408523d15cf95f0086d2 /build/ci-notes.md
parentd8715fba1a366944a069397775fc52a30358eff3 (diff)
downloaddexon-4f7627972e4997965be6f3c406904ef613e14c20.tar.gz
dexon-4f7627972e4997965be6f3c406904ef613e14c20.tar.zst
dexon-4f7627972e4997965be6f3c406904ef613e14c20.zip
build: improve debian packaging
This commit tweaks the debian packaging tool: * All build environment metadata can now be overriden on the command line. This allows testing the CI build behaviour locally. * -unstable packages now actually contain the binaries (oops) * packages use Go 1.7 to build * archiving is skipped for PR builds
Diffstat (limited to 'build/ci-notes.md')
-rw-r--r--build/ci-notes.md29
1 files changed, 26 insertions, 3 deletions
diff --git a/build/ci-notes.md b/build/ci-notes.md
index 989cba6dd..39375ff4c 100644
--- a/build/ci-notes.md
+++ b/build/ci-notes.md
@@ -1,5 +1,4 @@
-Debian Packaging
-----------------
+# Debian Packaging
Tagged releases and develop branch commits are available as installable Debian packages
for Ubuntu. Packages are built for the all Ubuntu versions which are supported by
@@ -8,6 +7,7 @@ Canonical:
- Trusty Tahr (14.04 LTS)
- Wily Werewolf (15.10)
- Xenial Xerus (16.04 LTS)
+- Yakkety Yak (16.10)
Packages of develop branch commits have suffix -unstable and cannot be installed alongside
the stable version. Switching between release streams requires user intervention.
@@ -21,6 +21,29 @@ variable which Travis CI makes available to certain builds.
We want to build go-ethereum with the most recent version of Go, irrespective of the Go
version that is available in the main Ubuntu repository. In order to make this possible,
our PPA depends on the ~gophers/ubuntu/archive PPA. Our source package build-depends on
-golang-1.6, which is co-installable alongside the regular golang package. PPA dependencies
+golang-1.7, which is co-installable alongside the regular golang package. PPA dependencies
can be edited at https://launchpad.net/%7Elp-fjl/+archive/ubuntu/geth-ci-testing/+edit-dependencies
+## Building Packages Locally (for testing)
+
+You need to run Ubuntu to do test packaging.
+
+Add the gophers PPA and install Go 1.7 and Debian packaging tools:
+
+ $ sudo apt-add-repository ppa:gophers/ubuntu/archive
+ $ sudo apt-get update
+ $ sudo apt-get install build-essential golang-1.7 devscripts debhelper
+
+Create the source packages:
+
+ $ go run build/ci.go debsrc -workdir dist
+
+Then go into the source package directory for your running distribution and build the package:
+
+ $ cd dist/ethereum-unstable-1.5.0+xenial
+ $ dpkg-buildpackage
+
+Built packages are placed in the dist/ directory.
+
+ $ cd ..
+ $ dpkg-deb -c geth-unstable_1.5.0+xenial_amd64.deb