2016-09-30 20:03:08 +00:00
|
|
|
# Debian Packaging
|
2016-05-25 12:07:57 +00: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 09:04:26 +00:00
|
|
|
Canonical.
|
2016-05-25 12:07:57 +00: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 09:55:25 +00:00
|
|
|
## Launchpad
|
|
|
|
|
|
2016-05-25 12:07:57 +00: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 09:55:25 +00: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 12:07:57 +00: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 10:00:18 +00:00
|
|
|
our PPA always fetches a recent Go release for the upstream server and uses that.
|
2016-05-25 12:07:57 +00:00
|
|
|
|
2016-09-30 20:03:08 +00:00
|
|
|
## Building Packages Locally (for testing)
|
|
|
|
|
|
|
|
|
|
You need to run Ubuntu to do test packaging.
|
|
|
|
|
|
2019-09-12 10:00:18 +00:00
|
|
|
Install Go and the Debian packaging tools:
|
2016-09-30 20:03:08 +00:00
|
|
|
|
|
|
|
|
$ sudo apt-get update
|
2019-09-12 10:00:18 +00:00
|
|
|
$ sudo apt-get install build-essential golang devscripts debhelper python-bzrlib python-paramiko
|
2016-09-30 20:03:08 +00: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 11:11:33 +00:00
|
|
|
$ cd dist/ethereum-unstable-1.6.0+xenial
|
2016-09-30 20:03:08 +00:00
|
|
|
$ dpkg-buildpackage
|
|
|
|
|
|
|
|
|
|
Built packages are placed in the dist/ directory.
|
|
|
|
|
|
|
|
|
|
$ cd ..
|
2017-04-13 11:11:33 +00:00
|
|
|
$ dpkg-deb -c geth-unstable_1.6.0+xenial_amd64.deb
|
