Prerequisites

Before connecting Buildkite to Pierre, ensure you have:

• An active Pierre workspace
• A Buildkite account with organization admin permissions
• At least one repository set up in Pierre that you want to monitor with Buildkite

Step 1: Setting Up Your API Token in Buildkite

To allow Pierre to access your Buildkite data:

1. Log in to your Buildkite account at buildkite.com
2. Navigate to Personal Settings → API Access
3. Click New API Token
4. Configure your token:
   • Name: "Pierre Integration" (or any descriptive name)
   • Scopes: Select write_builds and read_organizations
   • Description: Optional note about the integration purpose
5. Click Create API Token
6. Important: Copy the generated token immediately - you won't be able to see it again

Step 2: Adding Buildkite to Pierre

1. Log in to your Pierre account
2. Go to your Workspace Settings
3. Find the Integrations section
4. Locate the Buildkite integration card
5. Paste your Buildkite API token
6. Click Save

Pierre will verify the connection and display your connected Buildkite organization.

Step 3: Repository Access Setup

1. Choose your repository in Workspace Settings and connect it using the pipeline slug you would like to trigger

2. In your Buildkite pipeline, go to Pipeline Settings → Environment Variables

3. Add a new environment variable:

   • Name: GIT_SSH_CHECKOUT_PLUGIN_SSH_KEY
   • Value: Your SSH private key contents

4. Update your .buildkite/pipeline.yml to include the git-ssh-checkout plugin:

steps:
  - command: 'your build commands'
    plugins:
      - git-ssh-checkout#v0.3.2:

Step 4: Configuring Webhook Notifications

To ensure Pierre receives real-time updates about your builds:

1. In Buildkite, go to the pipeline you want to monitor
2. Navigate to Pipeline Settings → Notifications
3. Click Add Webhook
4. Configure the webhook:
   • URL: https://pierre.rip/webhooks/buildkite
   • Events: Select all build and job events (Build started, Build finished, Job started, Job finished)
5. Click Add Webhook

Common Integration Issues

If build statuses aren't showing up in Pierre:

1. Verify the webhook URL is exactly https://pierre.rip/webhooks/buildkite
2. Check that your API token has the required permissions
3. Ensure the webhook is configured for the correct pipeline