cdktf-aws-codebuild-github-runners-organization

CDKTF app that deploys a GitHub repository within an organization, along with an organization webhook that triggers self-hosted runners in AWS CodeBuild when workflow jobs are queued.

Related Apps

• cdktf-aws-codebuild-github-runners - Uses a GitHub repository webhook instead of organization webhook.
• cdk-aws-codebuild-github-runners - Uses a GitHub repository webhook instead of organization webhook; built with AWS CDK instead of CDKTF.

Prerequisites

• AWS:
  • Must have authenticated with Default Credentials in your local environment.
• GitHub:
  • Must have set the GITHUB_TOKEN and GITHUB_OWNER variables in your local environment.
• Terraform:
  • Must be installed in your system.
• Node.js + npm:
  • Must be installed in your system.

Installation

npx projen install

Deployment

npx projen deploy

Usage

1. Access the GitHub Actions workflow by clicking the <GHA_WORKFLOW_URL>:

   GhaWorkflowUrl = <GHA_WORKFLOW_URL>

2. Click Run workflow ➜ Run workflow.

3. Your workflow will be enqueued and run on an ephemeral EC2 instance managed by AWS CodeBuild.

Cleanup

npx projen destroy

Architecture Diagram