horizon-deb-packager

(formerly horizon-pkg)

Introduction

A project used to create and publish Debian packages and Ubuntu snaps of the Horizon platform. Current supported platforms include:

• Debian jessie, sid on armhf
• Raspbian jessie, sid on armhf
• Ubuntu xenial, yakkety on armhf, arm64, amd64, ppc64

Related Projects:

• anax (http://github.com/open-horizon/anax): The client control application in the Horizon system
• anax-ui (http://github.com/open-horizon/anax-ui): The source for the Anax web UI
• raspbian-image (http://github.com/open-horizon/raspbian-image): The Raspbian image builder for Raspberry Pi 2 and 3 models dedicated to Horizon

Manual use

Publishing new versions

Steps:

1. Check out this repository using the ssh clone method
2. Update the VERSION string in this repository's root directory. Use the following criteria:
   • Increment the micro version (z in x.y.z) if there are changes in the source repositores that are limited to bug fixes
   • Increment the minor version (y in x.y.z) if source changes only include new features or other non-breaking changes to the system
   • Increment the major version (x in x.y.z) if there are any source changes that change external interfaces or configuration files such that old clients will fail to behave with the new version as they could with older versions and configuration or if the behavior of the system changes substantially such that existing users cannot expect the same behavior of the new version as they could from older versions
3. Execute make meta[-distribution_name]
4. Review the changes to the local repository as instructed by cli output
5. If satisfied with the proposed changes, execute make publish-meta

Build agent

Docker build agent container creation command examples:

docker build -t hzn-build -f ./continuous_delivery/Dockerfile-bld-$(tools/arch-tag) .

Note: You must have appropriate SSH keys added to the agent to: 1) pull code from the repository, and 2) push built packages to the apt signing system.

Docker start command example:

docker run --rm --name hzn-build --hostname=$(hostname) -v /root/.ssh-aptrepo-signer:/root/.ssh:ro -v /root/go/.cache:/root/go/.cache:rw -v /root/.package_cache:/root/.package_cache:rw -it hzn-build:latest /bin/bash -c '/prj/continuous_delivery/bin/watch-build 1 "/horizon-deb-packager" "http://pkg.bluehorizon.network/linux/##DIST##/dists/##RELEASE##-testing/main" "aptsigner:/incoming" "https://hooks.slack.com/services/..." [restrict_to_distro1,restrict_to_distro2]'

Manual build with a build agent

In order to execute make meta inside a container, you need ssh credentials in-container and/or the ssh agent's authorization socket mounted into the build container. You can execute it this way:

docker run --rm --name hzn-build -v ${SSH_AUTH_SOCK}:${SSH_AUTH_SOCK} -e SSH_AUTH_SOCK="${SSH_AUTH_SOCK}" -v /root/.ssh-github:/root/.ssh -v $PWD:/horizon-deb-packager -it hzn-build /bin/bash

Inside the container, change the VERSION and then execute the build steps (constraining the packages to xenial in the example below):

make verbose=y meta

make verbose=y $(make show-packages | xargs -n1 | grep xenial | xargs)