diff --git a/docs/assets/images/BuildkiteTartPlugin.png b/docs/assets/images/BuildkiteTartPlugin.png new file mode 100644 index 0000000..f04b471 Binary files /dev/null and b/docs/assets/images/BuildkiteTartPlugin.png differ diff --git a/docs/integrations/buildkite.md b/docs/integrations/buildkite.md new file mode 100644 index 0000000..5c17556 --- /dev/null +++ b/docs/integrations/buildkite.md @@ -0,0 +1,21 @@ +# Buildkite + +It is possible to run [Buildkite](https://buildkite.com/) pipeline steps in isolated ephemeral Tart Virtual Machines with the help of [Tart Buildkite Plugin](https://github.com/cirruslabs/tart-buildkite-plugin): + +![](/assets/images/BuildkiteTartPlugin.png) + +## Configuration + +The most basic configuration looks like this: + +```yaml +steps: +- command: uname -a + plugins: + - cirruslabs/tart#main: + image: ghcr.io/cirruslabs/macos-sonoma-base:latest +``` + +This will run `uname -r` in a macOS Tart VM cloned from `ghcr.io/cirruslabs/macos-sonoma-base:latest`. + +See plugin's [Configuration section](https://github.com/cirruslabs/tart-buildkite-plugin#configuration) for the full list of available options. diff --git a/mkdocs.yml b/mkdocs.yml index 9c8306d..2781a37 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -91,6 +91,7 @@ nav: - "Integrations": - "GitHub Actions": integrations/github-actions.md - "GitLab Runner": integrations/gitlab-runner.md + - "Buildkite": integrations/buildkite.md - "Self-hosted CI": integrations/cirrus-cli.md - "Managing VMs": integrations/vm-management.md - "Support & Licensing": licensing.md