Flow Documentation
Company PagePlatform Status
  • Overview
  • Platform
    • Release Notes
    • Pricing
      • Compute
      • Kubernetes
      • App Engine
      • Object Storage
      • Mac Bare Metal
      • CI Engine
      • DevOps Services
      • Volumes & Snapshots
      • Load Balancers
      • Elastic IPs
      • VPN & Peering
      • Licenses
      • Support
      • Billing FAQ
    • Account
      • Sign Up
      • Closing account
    • Cashback Program
    • Support
      • Case severity and initial response times
    • Service Level Agreement (SLA)
    • Security & Compliance
      • Log4j Vulnerability
    • Regions
      • ALP1
      • ALP2
      • ZRH1
  • Products
    • Compute
      • Instances
        • How-to
          • Connect to instances
          • Destroy Instances
      • Volumes
      • Keypairs
      • ▫️Networking
        • Private Networks
        • Routers
        • Security Groups
        • Elastic IPs
        • Load Balancers
          • Balancing Pools
        • Certificates
        • VPN & Peering
    • Kubernetes
      • Clusters
      • Resources
        • Volumes Features (CSI)
        • External Load Balancers
        • Cluster Autoscaler
        • Traefik upgrade and tests
        • Update custom resource definitions (CRDs) for VolumeSnapshots
    • Object Storage
      • Instances
      • How-to
        • Access Storage with AWS S3 SDKs
        • Access Storage with Cyberduck
        • Access Storage with Mountainduck
      • Ressources
        • Supported Amazon S3 features
        • Replication Management
          • GET service replication
          • PUT service replication
          • DELETE service replication
    • App Engine
      • Accounts
    • Mac Bare Metal
      • Devices
      • How-to
        • Connect via Remote Desktop
        • Connect via SSH
        • Change Display Resolution
        • Connect local USB devices
      • Resources
        • Deprovisioning
    • CI Engine
      • Subscriptions
      • How-to
        • Setup GitHub Actions Integration
        • Setup Buildkite Integration
        • Customise Image
        • Enable Debug Mode
        • Change Image of Integration
      • Resources
        • Runners & Concurrency
        • Vanilla Images
          • macOS 15.2 - Vanilla
        • Golden Images
          • macOS 15.2 - Golden
        • Custom Images
  • Developer Center
    • Overview
    • API
      • Product Entities
      • Location Entities
    • CLI
    • Terraform
Powered by GitBook
On this page
  1. Products
  2. CI Engine
  3. How-to

Setup Buildkite Integration

PreviousSetup GitHub Actions IntegrationNextCustomise Image

Last updated 3 months ago

To integrate Buildkite with your CI-Engine subscription, follow the steps below:

  1. Navigate to CI-Engine > .

  2. Click on the (+) Plus sign.

  3. Choose the subscription for which you create the integration.

  4. Choose Buildkite as the CI-provider of the integration.

  5. Choose a global or custom image for your runners to use.

    1. You can always later.

  6. Configure the runners to connect to your repository.

    1. Setup an

    2. Define a runner timeout, after which a runner without an active build job will be terminated.

  7. Give your integration a name.

  8. Configure a

  9. Add the displayed public .

Once you finished the steps above you are ready to build! Simply trigger the Workflow you just updated to run on CI-Engine and check the state of your runners on the detail page of your subscription.

Agent Token Configuration

The is used to authenticate and connect the agent on each new runner to your pipeline. We support both clustered and unclustered tokens. However we strongly suggest the usage of a clustered agent token as this is the new default for Buildkite agent tokens. You can find out more about unclustered Buildkite agent tokens .

Webhook Configuration

To spawn the runners on demand you need to setup Webhooks in your Buildkite pipeline:

  1. In your Buildkite dashboard, go to Settings > Notification Services and click on the Add-Button for webhooks.

  2. Configure the Webhook URL and the Token that are provided in the Wizard-Step. Alternatively you can find this information on the details page of your integration by clicking on (•••) More button and View Webhook Config.

  3. Configure the Webhook Notifications by selecting the Events job.scheduled and job.finished. These Events are required for the runners to spawn correctly.

SSH Configuration

To give the runner access to clone your repository during the jobs you need to add the SSH public key that is provided on this step to your git provider. Most providers support a deploy key that can be used for this purpose. For more instructions you can follow the official documentation of your provider:

GitLab
GitHub
BitBucket
Integrations
change the image of the integration
agent token
here
Agent Token at Buildkite
webhook at Buildkite
SSH key to your repository