https://github.com/drakon64/github-actions-runner-aws

Ephemeral GitHub Actions runners on AWS EC2
https://github.com/drakon64/github-actions-runner-aws

Last synced: 1 day ago
JSON representation

Ephemeral GitHub Actions runners on AWS EC2

• Host: GitHub
• URL: https://github.com/drakon64/github-actions-runner-aws
• Owner: drakon64
• License: mit
• Created: 2024-05-12T21:13:28.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2024-05-22T15:04:04.000Z (6 months ago)
• Last Synced: 2024-05-22T17:14:44.670Z (6 months ago)
• Language: Rust
• Homepage:
• Size: 104 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# github-actions-runner-aws

`github-actions-runner-aws` is a serverless function for running ephemeral GitHub Actions runners in AWS EC2.

For each workflow job in a repository, a webhook is sent to AWS API Gateway. This runs a Lambda function that creates an EC2 instance with the GitHub Actions runner deployed. When the workflow job is completed, another webhook terminates the EC2 instance.

# Building

To compile `github-actions-runner-aws` so that the included OpenTofu configuration can deploy it, run:

`cargo lambda build --release --arm64 --output-format zip`

# Deploying

`github-actions-runner-aws` can be deployed with OpenTofu by running:

```shell

cd terraform

tofu apply

```

# Roadmap

* Automatically terminate stale workflows

* Cleanup code

* Improve error handling

* Remove repository owner hack

* Documentation