2016-09-30 15:03:08 -05:00
|
|
|
# Debian Packaging
|
2016-05-25 07:07:57 -05:00
|
|
|
|
|
|
|
|
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
|
2018-02-19 03:04:26 -06:00
|
|
|
Canonical.
|
2016-05-25 07:07:57 -05:00
|
|
|
|
|
|
|
|
Packages of develop branch commits have suffix -unstable and cannot be installed alongside
|
|
|
|
|
the stable version. Switching between release streams requires user intervention.
|
|
|
|
|
|
2019-02-12 03:55:25 -06:00
|
|
|
## Launchpad
|
|
|
|
|
|
2016-05-25 07:07:57 -05:00
|
|
|
The packages are built and served by launchpad.net. We generate a Debian source package
|
|
|
|
|
for each distribution and upload it. Their builder picks up the source package, builds it
|
|
|
|
|
and installs the new version into the PPA repository. Launchpad requires a valid signature
|
2019-02-12 03:55:25 -06:00
|
|
|
by a team member for source package uploads.
|
|
|
|
|
|
|
|
|
|
The signing key is stored in an environment variable which Travis CI makes available to
|
|
|
|
|
certain builds. Since Travis CI doesn't support FTP, SFTP is used to transfer the
|
|
|
|
|
packages. To set this up yourself, you need to create a Launchpad user and add a GPG key
|
|
|
|
|
and SSH key to it. Then encode both keys as base64 and configure 'secret' environment
|
|
|
|
|
variables `PPA_SIGNING_KEY` and `PPA_SSH_KEY` on Travis.
|
2016-05-25 07:07:57 -05:00
|
|
|
|
|
|
|
|
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,
|
2019-09-12 06:23:34 -05:00
|
|
|
our PPA depends on the ~gophers/ubuntu/archive PPA. Our source package build-depends on
|
|
|
|
|
golang-1.11, which is co-installable alongside the regular golang package. PPA dependencies
|
|
|
|
|
can be edited at https://launchpad.net/%7Eethereum/+archive/ubuntu/ethereum/+edit-dependencies
|
2016-05-25 07:07:57 -05:00
|
|
|
|
2016-09-30 15:03:08 -05:00
|
|
|
## Building Packages Locally (for testing)
|
|
|
|
|
|
|
|
|
|
You need to run Ubuntu to do test packaging.
|
|
|
|
|
|
2019-09-12 06:23:34 -05:00
|
|
|
Add the gophers PPA and install Go 1.11 and Debian packaging tools:
|
2016-09-30 15:03:08 -05:00
|
|
|
|
2019-09-12 06:23:34 -05:00
|
|
|
$ sudo apt-add-repository ppa:gophers/ubuntu/archive
|
2016-09-30 15:03:08 -05:00
|
|
|
$ sudo apt-get update
|
2019-09-12 06:23:34 -05:00
|
|
|
$ sudo apt-get install build-essential golang-1.11 devscripts debhelper python-bzrlib python-paramiko
|
2016-09-30 15:03:08 -05:00
|
|
|
|
|
|
|
|
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:
|
|
|
|
|
|
2017-04-13 06:11:33 -05:00
|
|
|
$ cd dist/ethereum-unstable-1.6.0+xenial
|
2016-09-30 15:03:08 -05:00
|
|
|
$ dpkg-buildpackage
|
|
|
|
|
|
|
|
|
|
Built packages are placed in the dist/ directory.
|
|
|
|
|
|
|
|
|
|
$ cd ..
|
2017-04-13 06:11:33 -05:00
|
|
|
$ dpkg-deb -c geth-unstable_1.6.0+xenial_amd64.deb
|
