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

Create a step-by-step guide:

  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

      $ 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 

      $ sudo apt-get update

  4. Install the following necessary build packages

    1. Example

    $ sudo apt install lintian-profile-vyatta base-files-vyatta

  5. Clone the package source

    1. Example

      $ 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 

      $ sudo mk-build-deps --install debian/control

  7. Build the package using the Debian build tools

    1. Example 

      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

Related articles

The content by label feature displays related articles automatically, based on labels you choose. To edit options for this feature, select the placeholder below and tap the pencil icon.

Related issues

'