Repository files navigation

Using these Terraform modules you can quickly deploy self-hosted GitHub Runners for jobs in your GitHub Actions workflows

Thegh-runner-gke module provisions the resources required to deploy Self Hosted Runners on GCP infrastructure using GKE. This module follows the guidance for usingActions Runner Controller provided by GitHub

Examples:

• Simple Self Hosted Runners on GKE
• Self Hosted runners on GKE that support Docker Workflows
• Self Hosted runners on GKE that support Docker Workflows in rootless configuration

More examples ofSelf Hosted Runners on GKE/Anthos.

Thegh-runner-mig-vm module provisions the resources required to deploy Self Hosted Runners on GCP infrastructure using Managed Instance Groups.

Examples:

• Simple Self Hosted Runner on MIG VMs
• Self Hosted Runner on MIG VMs from Packer Image

Thegh-runner-mig-container-vm module provisions the resources required to deploy Self Hosted Runners on GCP infrastructure using Managed Instance Groups.

Examples:

• Simple Self Hosted Runner on MIG Container VMs
• Self Hosted runners on MIG Container VMs that support Docker Workflows

This module handles the opinionated creation of infrastructure necessary to configureWorkload Identity pools andproviders for authenticating to GCP using GitHub Actions OIDC tokens.

Examples:

• Simple Workload Identity configuration for GitHub OIDC

These sections describe requirements for using this module.

The following dependencies must be available:

• Terraform v0.13
• Terraform Provider for GCP

Refer to thecontribution guidelines forinformation on contributing to this module.

Please see oursecurity disclosure process.