diff --git a/HOWTO_VERIFY_RELEASES.md b/HOWTO_VERIFY_RELEASES.md new file mode 100644 index 00000000..f675ef44 --- /dev/null +++ b/HOWTO_VERIFY_RELEASES.md @@ -0,0 +1,62 @@ +How To Verify Releases +====================== + +Releases are built using the `./releases.sh` script, which relies on a couple of Docker images from [hub.docker.com/u/fstab/](https://hub.docker.com/u/fstab/). The Dockerfiles are maintained on [github.com/fstab/docker-grok_exporter-compiler](https://github.com/fstab/docker-grok_exporter-compiler). + +In order to run the ARM builds on an AMD64 processor you need `binfmt-support` and `qemu-user-static`, which is enabled by default in Docker for Mac. + +After building a release, I do a quick manual test to verify that the binaries work. This file contains some notes on how to manually verify the releases for the different platforms. + +linux-arm32v6 +------------- + +On a Linux system, follow the instructions from [github.com/dhruvvyas90/qemu-rpi-kernel](https://github.com/dhruvvyas90/qemu-rpi-kernel) to set up an emulated Raspberry PI system: + +```bash +#!/bin/bash + +set -e + +mkdir ~/qemu_vms +cd ~/qemu_vms +sudo apt-get install -y qemu-system-arm +curl -LO http://downloads.raspberrypi.org/raspbian_lite/images/raspbian_lite-2017-12-01/2017-11-29-raspbian-stretch-lite.zip +unzip 2017-11-29-raspbian-stretch-lite.zip +curl -LO https://github.com/dhruvvyas90/qemu-rpi-kernel/raw/master/versatile-pb.dtb +curl -LO https://github.com/dhruvvyas90/qemu-rpi-kernel/raw/master/kernel-qemu-4.9.59-stretch + +cat > run.sh <