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 2005 release is based on Debian 10 so you will need a Debian 10 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 from buster-backports installed.

    1. Example 

      $ apt-get -y install devscripts

  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://repos.danosproject.org.s3-website-us-west-1.amazonaws.com/repo/ 2005 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. Configure required package pinning priorities so that DANOS package are preferred over Debian packages

    1. Example 

      $ sudo tee /etc/apt/preferences.d/998danos << EOF
Package: *
Pin: release o=DANOS
Pin-Priority: 998
EOF

  5. Install the following necessary build packages

    1. Example

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

  6. Clone the package source

    1. Example

      $ git clone https://github.com/danos/configd
$ cd configd

  7. 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 --remove debian/control

  8. 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.

  9. Make your changes to the source

  10. 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

'