Skip to main content

Self-hosted runners

If your workflow needs access to the internal network, you'll need to use or set up a self-hosted runner.

Available runners​

Team Platform manages two sets of runners for common scenarios when developing in GAP.

IaC​

This runner is solely used for provisioning and managing resources. It's only accessible using the shared workflows for IaC.

DB​

This runner is using our default image and have access to the DB subnet. To use this runner, you'll need to add your repo to the platform_db_runner_group in terraform-github-config repo. Then use the appropriate runs-on block for the chosen cluster in your workflow:

runs-on:
  group: platform-db
  labels:
    - db-runner-[cluster_identifier]-test
Cluster identifier

Cluster identifiers are documented in Confluence.

Own runner​

In cases where you need access to internal network, running resource-heavy workloads or using custom tools that are time-consuming to set up/configure as part of your workflow on every run, you can build a custom image and use it in a separate runner group. This should be your last option, and remember, you build it you run it!