This is a collection of notes for my own use. It probably isn't very helpful to you, unless you are (a) already familiar with Buildkite and (b) doing a weird dance with Windows, WSL2, and a Raspberry Pi. This stuff works on my machine.
If you've never heard of Buildkite, go check it out: Buildkite. It's a pretty cool continuous integration tool.
Serve the docs locally (using WSL2)
Pipeline upload step
Paste this into the YAML steps editor when setting up a pipeline, so that you can use a
steps: - label: "Pipeline upload" command: buildkite-agent pipeline upload
Target a particular agent
This is useful when running both a Pi and a Windows agent.
- command: "<some command>" agents: os: "<os-tag>"
steps: - label: "Pipeline upload" command: buildkite-agent pipeline upload agents: os: "<some-os-tag>"
Start the agent
# Powershell (with admin privileges) nssm start buildkite-agent # Bash (via Raspberry Pi) # or WSL2 # no, Git Bash doesn't entirely work # and yes, working on this does require three operating systems # I'm fine, how 'bout you? ~/.buildkite-agent/bin/buildkite-agent start
Docs for installing on generic Linux - use this for Pi or WSL2, not whatever Linux distro you think you're using.
Docs for installing on Windows
Target a particular shell
shell option in
# PowerShell shell="C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe" # PowerShell Core shell="C:\Program^ Files\PowerShell\7\pwsh.exe" # Git Bash - do not use shell="C:\Program^ Files\Git\git-bash.exe"
Be aware of the following:
- PowerShell Core and WSL2 do not support using buildkite-agent pipeline upload directly in the steps editor. Workaround: put it in a script file, run that script from the steps editor.