Installing on Buildkite
This section is a work in progress.
Configure a Pipeline
Create a new Pipeline for your Workflows build or choose an existing one and configure it to your preference. If you use GitHub, follow these steps to integrate your repo with Buildkite.
Edit Steps and paste the following:
- key: aspect_ci_setup
label: ':aspect: Setup Aspect CI'
- 'rosetta steps | buildkite-agent pipeline upload'
<RUNNER_GROUP> with the name of the runner group in your terraform module declaration.
You can use the Buildkite provider for Terraform to set up your pipeline programatically.
The Workflows terraform module creates two secrets to populate.
Buildkite gent token. The agent token allows our runners to connect to Buildkite. Under your organization, click on the
Agents Tabthen click
Reveal Agent Token. Copy and paste this token into a secret named like
Git SSH key. If you use a private repository, set up an SSH key that Workflows runners can use to check out your repository. Under your pipeline's GitHub settings, select the
SSHradio button. Then, upload the private key to a secret with a name like
aw-git-ssh-key-<QUEUE>-XXXXXXXX. If you use GitHub, we recommend using a Deploy Key with readonly access.
The Workflows module exposes the names of the secrets it creates as an outputs. If you use a tool like Vault, you can wire in secret values automatically via Terraform.
Add a Workflows configuration file to your repository.