Skip to content

Commit 691b510

Browse files
committed
add documentation on how to verify releases
1 parent b627244 commit 691b510

File tree

1 file changed

+62
-0
lines changed

1 file changed

+62
-0
lines changed

HOWTO_VERIFY_RELEASES.md

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
How To Verify Releases
2+
======================
3+
4+
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).
5+
6+
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.
7+
8+
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.
9+
10+
linux-arm32v6
11+
-------------
12+
13+
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:
14+
15+
```bash
16+
#!/bin/bash
17+
18+
set -e
19+
20+
mkdir ~/qemu_vms
21+
cd ~/qemu_vms
22+
sudo apt-get install -y qemu-system-arm
23+
curl -LO http://downloads.raspberrypi.org/raspbian_lite/images/raspbian_lite-2017-12-01/2017-11-29-raspbian-stretch-lite.zip
24+
unzip 2017-11-29-raspbian-stretch-lite.zip
25+
curl -LO https://github.com/dhruvvyas90/qemu-rpi-kernel/raw/master/versatile-pb.dtb
26+
curl -LO https://github.com/dhruvvyas90/qemu-rpi-kernel/raw/master/kernel-qemu-4.9.59-stretch
27+
28+
cat > run.sh <<EOF
29+
qemu-system-arm \
30+
-kernel kernel-qemu-4.9.59-stretch \
31+
-cpu arm1176 \
32+
-m 256 \
33+
-M versatilepb \
34+
-dtb versatile-pb.dtb \
35+
-no-reboot \
36+
-append "root=/dev/sda2 panic=1 rootfstype=ext4 rw" \
37+
-net nic -net user,hostfwd=tcp::5022-:22 \
38+
-hda 2017-11-29-raspbian-stretch-lite.img
39+
EOF
40+
```
41+
42+
Some info on arm32v6, arm32v7, armhf, armel can be found on the [Raspbian FAQ](https://www.raspbian.org/RaspbianFAQ).
43+
44+
linux-arm64v8
45+
-------------
46+
47+
Create a Server on [Scaleway](https://cloud.scaleway.com).
48+
49+
linux-amd64
50+
-----------
51+
52+
Use a plain Ubuntu Docker image.
53+
54+
darwin-amd64
55+
------------
56+
57+
This is my local development machine.
58+
59+
windows-amd64
60+
-------------
61+
62+
Set up a VirtualBox VM.

0 commit comments

Comments
 (0)