Create a wiki with information / notes on how to setup buildkite for local testing?

[glwagner]

The first step is to install the buildkite-agent utility on the local machine:

https://buildkite.com/organizations/clima/agents

Then a tag needs to be added to the buildkite-agent.cfg file (for example, when buildkite is installed with a system package manager the default configuration file is located at /etc/buildkite-agent.cfg). We use two tags (for example):

tags="queue=Oceananigans,architecture=GPU"

Note that you may not be able to use a space after the comma between two tags. We also set the number of agents via the spawn keyword.

To start the buildkite agent as a system process, type

sudo systemctl start buildkite-agent

To stop a buildkite agent running as a system process, type

sudo systemctl stop buildkite-agent

Alternatively, buildkite-agent can be run in the background via tmux or screen.

When buildkite-agent is run as a system process, their status is viewed by typing

sudo systemctl status buildkite-agent