289b30715d
This commit converts the dependency management from Godeps to the vendor folder, also switching the tool from godep to trash. Since the upstream tool lacks a few features proposed via a few PRs, until those PRs are merged in (if), use github.com/karalabe/trash. You can update dependencies via trash --update. All dependencies have been updated to their latest version. Parts of the build system are reworked to drop old notions of Godeps and invocation of the go vet command so that it doesn't run against the vendor folder, as that will just blow up during vetting. The conversion drops OpenCL (and hence GPU mining support) from ethash and our codebase. The short reasoning is that there's noone to maintain and having opencl libs in our deps messes up builds as go install ./... tries to build them, failing with unsatisfied link errors for the C OpenCL deps. golang.org/x/net/context is not vendored in. We expect it to be fetched by the user (i.e. using go get). To keep ci.go builds reproducible the package is "vendored" in build/_vendor.
65 lines
2.8 KiB
Markdown
65 lines
2.8 KiB
Markdown
# Vendored Dependencies
|
|
|
|
Dependencies are almost all vendored in at the standard Go `/vendor` path. This allows
|
|
people to build go-ethereum using the standard toolchain without any particular package
|
|
manager. It also plays nicely with `go get`, not requiring external code to be relied on.
|
|
|
|
The one single dependent package missing from `vendor` is `golang.org/x/net/context`. As
|
|
this is a package exposed via public library APIs, it must not be vendored as dependent
|
|
code woulnd't be able to instantiate.
|
|
|
|
To allow reproducible builds of go-ethereum nonetheless that don't need network access
|
|
during build time to fetch `golang.org/x/net/context`, a version was copied into our repo
|
|
at the very specific `/build/_vendor` path, which is added automatically by all CI build
|
|
scripts and the makefile too.
|
|
|
|
# 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
|
|
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.
|
|
|
|
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
|
|
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.
|
|
|
|
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.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
|