README.md

cdktf-aws-codebuild-github-runners

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

Related Apps

• cdktf-aws-codebuild-github-runners-organization - Uses a GitHub organization webhook instead of repository webhook.
• cdk-aws-codebuild-github-runners - 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 variable in your local environment.
• Node.js + npm:
  • Must be installed in your system.

Installation

npx projen install

Deployment

npx projen deploy

Usage

1. Navigate to https://github.com/<GITHUB_OWNER>/sample-repo/actions/workflows/hello-world.yml.

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