openstf/stf-armv7l

Functionally equivalent to the openstf/stf Docker image, but runs on armv7l.

Manual build

To build the image, run the following commands from the repo root directory (not this directory) on an armv7l machine:

ARCH=armhf docker/armv7l/mkimage-alpine.sh
docker build -f docker/armv7l/Dockerfile -t openstf/stf-armv7l:latest .

Note that the build is very, very I/O and CPU-heavy. Don't run it daily on your microSD-backed board or the card will die.

Nightly build

The following instructions have only been tested on a Scaleway C1 running Arch Linux with the latest Docker-enabled kernel (currently 4.4.2).

This folder includes systemd unit files for an automatic nightly build. The build takes such a long time that there's no point in doing it in real time via hooks.

Once Scaleway tooling becomes a bit easier to approach we might automate the build server provisioning, but honestly it isn't that much work as you'll see.

First, copy the unit files into your build machine's /etc/systemd/system/ folder. Note that you may have to modify the docker image name inside the unit files if you're planning on pushing the nightly images.

cp stf-armv7l-* /etc/systemd/system/

Alternatively scp can be much easier depending on your setup:

scp stf-armv7l-* [email protected]:/etc/systemd/system

If you're upgrading the units or otherwise tweaking them, don't forget to let systemd know:

systemctl daemon-reload

Let's also make sure that docker and other deps are installed:

pacman -Sy
pacman -S docker git

Some of the unit files require a dedicated build user to exist, so let's create that:

useradd --system --create-home -G docker stf-armv7l

Before enabling docker, you may wish to change the storage driver to overlay:

systemctl edit docker

Enter the following contents. Note that I also tend to always lock down docker's --bip so that it can't accidentally conflict with any other range (which I've personally experienced in a complex network). Feel free to remove it if you wish.

[Service]
ExecStart=
ExecStart=/usr/bin/docker daemon -H fd:// -s overlay --bip 192.168.255.1/24

Now, enable and start docker:

systemctl enable docker
systemctl start docker

If you want to push the built images, you should login to docker:

docker login

Now all you need to do is enable and start the timer.

systemctl enable stf-armv7l-publish-latest.timer
systemctl start stf-armv7l-publish-latest.timer

You can also publish tags and other branches manually by:

systemctl start [email protected]

Note that the command won't return for a long long time. You can check progress by running journalctl -f if necessary.