Buildkite

Batect can run on any Buildkite agent that meets Batect's system requirements - chiefly Docker and a JVM.

Running with command evaluation disabled#

Buildkite supports disabling command evaluation, which requires all build scripts to be invoked without arguments and take any necessary input as environment variables. This prevents the use of the Batect wrapper script, as it expects to receive the task name and other options as command line options.

There are two solutions to this:

Option 1: create step-specific shell scripts that invoke Batect#

In this scenario, you create multiple shell scripts, one for each step in Buildkite.

For example, let's say you have three steps in Buildkite: one for building, one for testing, and another for packaging. You would need to create a separate script for each of these steps that invokes Batect, for example:

build.sh
#! /usr/bin/env bash
set -euo pipefail
./batect build
test.sh
#! /usr/bin/env bash
set -euo pipefail
./batect unitTest
./batect integrationTest
./batect journeyTest
package.sh
#! /usr/bin/env bash
set -euo pipefail
./batect package

Option 2: create a wrapper script that takes the task name as an environment variable#

In this scenario, you create a single shell script and invoke it with different environment variable values for each step.

A script that executes the task given in the BATECT_TASK environment variable is:

batect-wrapper.sh
#! /usr/bin/env bash
set -euo pipefail
./batect "$BATECT_TASK"

Configure this in your Buildkite pipeline.yml as follows:

pipeline.yml
steps:
- label: Run build
command: batect-wrapper.sh
env:
BATECT_TASK: build
- label: Run unit tests
command: batect-wrapper.sh
env:
BATECT_TASK: unitTest
# ...and so on