Building a package from source -- 1908

Building packages on Debian 10 is not yet supported. You must use Debian 9 to build packages.

This article describes the general procedure for building DANOS packages from source. Packages must be built on a Debian host that corresponds to the version of Debian for the given DANOS release. The initial 1908 release is based on Debian 9 so you will need a Debian 9 environment of some kind to get started. The particular flavor of Debian environment is up to you, VM, container, chroot, etc.

These instructions have been automated using a Docker based environment in the following tool https://github.com/jsouthworth/danos-buildpackage. If you have Docker installed this tool may be run from the root of a package directory to build the package. It supports advanced build modes such as building against other local packages that have previously been built. Binaries for Linux (.elf), macOS (.mach-o), and Windows 10 (.exe) are available in the Releases tab for the tool.

Instructions

  1. Setup a Debian environment for development with the “devscripts” package installed.

  2. Add the Debian repos and signing keys for the given DANOS Release

    1. Example

      1 2 3 4 5 6 $ sudo tee /etc/apt/sources.list.d/danos.list << EOF deb http://s3-us-west-1.amazonaws.com/repos.danosproject.org/standard/ 1908 main deb http://s3-us-west-1.amazonaws.com/repos.danosproject.org/bootstrap/ 1908 main EOF $ wget -q -O- https://s3-us-west-1.amazonaws.com/repos.danosproject.org/Release.key | sudo apt-key add -
  3. Use ‘apt-get update’ to update the package cache

    1. Example

      1 $ sudo apt-get update
  4. Install the following necessary build packages

    1. Example

    1 $ sudo apt install lintian-profile-vyatta base-files-vyatta
  5. Clone the package source

    1. Example

      1 2 $ git clone https://github.com/danos/configd $ cd configd
  6. Install the build dependencies for the package you will be working on using the mk-build-deps script

    1. Example

      1 $ sudo mk-build-deps --install debian/control
  7. Build the package using the Debian build tools

    1. Example

      1 debuild -uc -us -i -b
    2. Note that you may see lintian warnings (W:) or non-fatal errors (E:). Before assuming your build has failed, check whether any ‘.deb’ files have been created / updated in the parent directory.

  8. Make your changes to the source

  9. Rebuild the package using the Debian build tools again

'