Terraform Modules for GitHub Runner Orchestration

Using Terraform for managing GitHub Actions runners can significantly streamline your development workflow. RunJob provides the following Terraform modules:

• puzl-cloud/githubactionsintegration/puzl
• puzl-cloud/githubrunnerclaim/puzl

Module for GitHub Integration with RunJob

The module forms the foundation of your integration process. It creates a GitHubActionsIntegration resource, which links your GitHub organization(s) with RunJob service. When integrating this module, you create a unique namespace that serves as the base for your GitHubRunnerClaim resources.

Module for GitHub Runner Claim on RunJob

The module allows for the provisioning of GitHub runners specific to your project's needs. Integration into your existing Terraform setup involves defining a GitHubRunnerClaim resource. This resource should be configured within the namespace created by the GitHubPipelinesIntegration module, ensuring isolation of your runners.

Example

The example Terraform setup can be found here. It creates GitHubActionsIntegration and GitHubRunnerClaim resources.