github.com/blockchain-foundry/go-ethereum@v1.5.9/build/ci-notes.md (about)

     1  # Vendored Dependencies
     2  
     3  Dependencies are almost all vendored in at the standard Go `/vendor` path. This allows
     4  people to build go-ethereum using the standard toolchain without any particular package
     5  manager. It also plays nicely with `go get`, not requiring external code to be relied on.
     6  
     7  The one single dependent package missing from `vendor` is `golang.org/x/net/context`. As
     8  this is a package exposed via public library APIs, it must not be vendored as dependent
     9  code woulnd't be able to instantiate.
    10  
    11  To allow reproducible builds of go-ethereum nonetheless that don't need network access
    12  during build time to fetch `golang.org/x/net/context`, a version was copied into our repo
    13  at the very specific `/build/_vendor` path, which is added automatically by all CI build
    14  scripts and the makefile too.
    15  
    16  # Debian Packaging
    17  
    18  Tagged releases and develop branch commits are available as installable Debian packages
    19  for Ubuntu. Packages are built for the all Ubuntu versions which are supported by
    20  Canonical:
    21  
    22  - Trusty Tahr (14.04 LTS)
    23  - Wily Werewolf (15.10)
    24  - Xenial Xerus (16.04 LTS)
    25  - Yakkety Yak (16.10)
    26  
    27  Packages of develop branch commits have suffix -unstable and cannot be installed alongside
    28  the stable version. Switching between release streams requires user intervention.
    29  
    30  The packages are built and served by launchpad.net. We generate a Debian source package
    31  for each distribution and upload it. Their builder picks up the source package, builds it
    32  and installs the new version into the PPA repository. Launchpad requires a valid signature
    33  by a team member for source package uploads. The signing key is stored in an environment
    34  variable which Travis CI makes available to certain builds.
    35  
    36  We want to build go-ethereum with the most recent version of Go, irrespective of the Go
    37  version that is available in the main Ubuntu repository. In order to make this possible,
    38  our PPA depends on the ~gophers/ubuntu/archive PPA. Our source package build-depends on
    39  golang-1.7, which is co-installable alongside the regular golang package. PPA dependencies
    40  can be edited at https://launchpad.net/%7Eethereum/+archive/ubuntu/ethereum/+edit-dependencies
    41  
    42  ## Building Packages Locally (for testing)
    43  
    44  You need to run Ubuntu to do test packaging.
    45  
    46  Add the gophers PPA and install Go 1.7 and Debian packaging tools:
    47  
    48      $ sudo apt-add-repository ppa:gophers/ubuntu/archive
    49      $ sudo apt-get update
    50      $ sudo apt-get install build-essential golang-1.7 devscripts debhelper
    51  
    52  Create the source packages:
    53  
    54      $ go run build/ci.go debsrc -workdir dist
    55  
    56  Then go into the source package directory for your running distribution and build the package:
    57  
    58      $ cd dist/ethereum-unstable-1.5.0+xenial
    59      $ dpkg-buildpackage
    60  
    61  Built packages are placed in the dist/ directory.
    62  
    63      $ cd ..
    64      $ dpkg-deb -c geth-unstable_1.5.0+xenial_amd64.deb