{"id":21213981,"url":"https://github.com/cruxstack/terraform-aws-github-runner","last_synced_at":"2026-02-28T00:40:12.653Z","repository":{"id":182171568,"uuid":"668060085","full_name":"cruxstack/terraform-aws-github-runner","owner":"cruxstack","description":"Terraform module for self-hosted scalable GitHub action runners on dedicated AWS EC2 instances","archived":false,"fork":false,"pushed_at":"2025-02-28T15:32:52.000Z","size":30,"stargazers_count":2,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-08T23:23:36.286Z","etag":null,"topics":["aws","cloudposse","docker","github","github-actions","scaleable","self-hosted","self-hosted-runner","sweetops","terraform","terraform-module"],"latest_commit_sha":null,"homepage":"https://registry.terraform.io/modules/cruxstack/github-runner/aws/latest","language":"HCL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cruxstack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-18T23:54:54.000Z","updated_at":"2025-02-28T15:32:42.000Z","dependencies_parsed_at":"2023-07-19T01:23:12.243Z","dependency_job_id":"f6773482-1862-461d-9423-d176ec7c9c60","html_url":"https://github.com/cruxstack/terraform-aws-github-runner","commit_stats":null,"previous_names":["sgtoj/terraform-aws-github-runner","cruxstack/terraform-aws-github-runner"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/cruxstack/terraform-aws-github-runner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cruxstack%2Fterraform-aws-github-runner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cruxstack%2Fterraform-aws-github-runner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cruxstack%2Fterraform-aws-github-runner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cruxstack%2Fterraform-aws-github-runner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cruxstack","download_url":"https://codeload.github.com/cruxstack/terraform-aws-github-runner/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cruxstack%2Fterraform-aws-github-runner/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278358488,"owners_count":25973946,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","cloudposse","docker","github","github-actions","scaleable","self-hosted","self-hosted-runner","sweetops","terraform","terraform-module"],"created_at":"2024-11-20T21:25:19.087Z","updated_at":"2025-10-04T18:43:11.617Z","avatar_url":"https://github.com/cruxstack.png","language":"HCL","readme":"# Terraform Module: AWS GitHub Action Runner\n\nThis Terraform module deploys autoscaling, self-hosted GitHub Action runners on\ndedicated EC2 instances. It is an extension of the popular [`philips-labs/github-runner/aws` module](https://github.com/philips-labs/terraform-aws-github-runner),\n with additional features to add value to your GitHub Action runners.\n\n## Features\n\n- **Auto-Scaling Runners**: Automatically scales the number of runners based on\n  demand.\n- **Ephemeral Runners**: Provides an option to use ephemeral runners that are\n  destroyed after use.\n- **Tag-Based Runner Assignment**: Uses tags to assign runners to specific\n  tasks.\n- **Custom Runner Configuration**: Allows custom configuration of runners,\n  including instance types, AMIs, and more.\n- **Instance Store RAID**: If more than 2 instance stores are detected, they are\n  combined into a `RAID0` configuration for improved performance.\n- **Automated Docker Login**: If custom Docker authentication is configured, the\n  runners will automatically perform a `docker login`.\n\n## Usage\n\n```hcl\nmodule \"github_runner\" {\n  source  = \"cruxstack/github-runner/aws\"\n  version = \"x.x.x\"\n\n  github_app_secrets = {\n    id  = \"your_github_app_id\"\n    key = \"your_github_app_key\"\n  }\n\n  github_organization = \"your_github_organization_name\"\n}\n```\n\n## Inputs\n\nIn addition to the variables documented below, this module includes several\nother optional variables (e.g., `name`, `tags`, etc.) provided by the\n`cloudposse/label/null` module. Please refer to the [`cloudposse/label` documentation](https://registry.terraform.io/modules/cloudposse/label/null/latest) for more details on these variables.\n\n| Name                                 | Description                                                                                 | Type           | Default                               | Required |\n|--------------------------------------|---------------------------------------------------------------------------------------------|----------------|---------------------------------------|:--------:|\n| `github_app_secrets`                 | Object containing `id` and `key` for the GitHub app.                                        | `object`       | n/a                                   |   yes    |\n| `github_organization`                | Name of the GitHub organization.                                                            | `string`       | n/a                                   |   yes    |\n| `github_app_webhook_password`        | Password for the GitHub app webhook. An empty string implies a randomly generated password. | `string`       | `\"\"`                                  |    no    |\n| `github_organization_runner_enabled` | Toggle to activate runners for all projects in the organization.                            | `bool`         | `true`                                |    no    |\n| `runner_binaries_path`               | Path to the GitHub Action runner binaries saved locally before pushed to S3.                | `string`       | `\"\"`                                  |    no    |\n| `runner_ephemeral_mode_enabled`      | Toggle to activate ephemeral runners.                                                       | `bool`         | `false`                               |    no    |\n| `runner_os`                          | Operating system for the GitHub Action runner.                                              | `string`       | `\"linux\"`                             |    no    |\n| `instance_ami_name`                  | Name of the Amazon Machine Image (AMI) for the GitHub Action runner.                        | `string`       | `\"al2023-ami-2023.*-kernel-*-x86_64\"` |    no    |\n| `instance_types`                     | Set of instance types for the action runner.                                                | `set(string)`  | `[\"m5ad.large\", \"m5d.large\"]`         |    no    |\n| `instance_lifecycle_type`            | Lifecycle type for action runner instances. Options: `spot` or `on-demand`.                 | `string`       | `\"spot\"`                              |    no    |\n| `log_retention`                      | Retention period (in days) for logs in CloudWatch.                                          | `number`       | `90`                                  |    no    |\n| `vpc_id`                             | ID of the Virtual Private Cloud (VPC).                                                      | `string`       | n/a                                   |   yes    |\n| `vpc_subnet_ids`                     | List of subnet IDs within the VPC.                                                          | `list(string)` | n/a                                   |   yes    |\n| `aws_region_name`                    | AWS region.                                                                                 | `string`       | `\"\"`                                  |    no    |\n| `aws_account_id`                     | AWS account ID.                                                                             | `string`       | `\"\"`                                  |    no    |\n| `aws_kv_namespace`                   | Namespace or prefix for AWS SSM parameters and similar resources.                           | `string`       | `\"\"`                                  |    no    |\n\n## Outputs\n\n| Name               | Description                                     |\n|--------------------|-------------------------------------------------|\n| `runners`          | Information about the runner resources created. |\n| `webhook_endpoint` | Endpoint for the webhook resources.             |\n| `webhook_password` | Password for the webhook resources.             |\n\n\n## Contributing\n\nWe welcome contributions to this project. For information on setting up a\ndevelopment environment and how to make a contribution, see [CONTRIBUTING](./CONTRIBUTING.md)\ndocumentation.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcruxstack%2Fterraform-aws-github-runner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcruxstack%2Fterraform-aws-github-runner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcruxstack%2Fterraform-aws-github-runner/lists"}