Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/runs-on/runs-on
Cheap, fast, ephemeral self-hosted runners for your GitHub Action workflows, in your AWS account
https://github.com/runs-on/runs-on
aws github-actions self-hosted
Last synced: 2 months ago
JSON representation
Cheap, fast, ephemeral self-hosted runners for your GitHub Action workflows, in your AWS account
- Host: GitHub
- URL: https://github.com/runs-on/runs-on
- Owner: runs-on
- License: other
- Created: 2023-12-09T12:44:10.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-19T17:03:36.000Z (about 1 year ago)
- Last Synced: 2023-12-19T17:13:54.963Z (about 1 year ago)
- Topics: aws, github-actions, self-hosted
- Language: JavaScript
- Homepage: https://github.com/runs-on/runs-on
- Size: 524 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-runners - runs-on/runs-on - on/runs-on.svg)](https://github.com/runs-on/runs-on/blob/master/LICENSE) [](https://github.com/runs-on/runs-on/graphs/contributors/) [](https://github.com/runs-on/runs-on/stargazers/) [](https://GitHub.com/runs-on/runs-on/issues/) [](https://GitHub.com/runs-on/runs-on/issues?q=is%3Aissue+is%3Aclosed) | AWS EC2 | ✅ | Repo, Dynamic Labels | On-demand | ✅ | x86, AMD64, ARM64 | ✅ | No PAT, only JIT token | Auto-cleanup | No runtime privilege | GitHub App exposed | AllInOne and custom images possible | yes (Actions Workflow) | $15/month | (The matrix (might be better readable on [GitHub pages](https://jonico.github.io/awesome-runners/)) / A word about self-hosted action runner images / virtual environments and how to test locally)
README
# RunsOn: 10x cheaper GitHub Actions runners.
**Remove 90% of your CI spend**. **Faster** builds. **Fully self-hosted**, in your AWS account.
RunsOn is the **modern way to run self-hosted GitHub Actions runners** of any size, at the cheapest price available. Think of it as your best alternative to the Actions Runner Controller (ARC) for Kubernetes, the Philips terraform module, or any of the third party providers that require deep access to your code and secrets.
- ✅ **Faster**. Raw [CPU performance is up 30%](https://runs-on.com/benchmarks/github-actions-runners/) compared to official runners.
- ✅ **Cheaper**. Between [7x to 15x cheaper](https://runs-on.com/pricing/) than official runners.
- ✅ **Scalable**. Handles bursts of multiple hundred jobs at once without issue. No concurrency limit.
- ✅ **Full workflow compatibility** with official GitHub runners. Use the [compatible public AMIs for AWS](https://github.com/runs-on/runner-images-for-aws), or [bring your own images](https://runs-on.com/features/byoi/).
- ✅ **Low maintenance**. A single [CloudFormation template](./cloudformation/template.yaml) with all the resources, 1-click install, 1-click upgrades. Costs $1.5/month.
## Features
- [Linux](https://runs-on.com/runners/linux) (x64 and arm64), [Windows](https://runs-on.com/runners/windows), [GPU](https://runs-on.com/runners/gpu) support.
- **Ephemeral VM** for each job.
- [Spot pricing](https://runs-on.com/features/spot-instances/), with **automatic fallback** to on-demand.
- Multi-AZ, and multi-[environments](https://runs-on.com/configuration/environments/) support.
- **Fast and unlimited GitHub Actions cache**: An [integrated cache backend](https://runs-on.com/caching/s3-cache-for-github-actions/) based on a local S3 bucket allows for up to 5x faster and unlimited cache for dependencies and docker layers.
- **SSH access** into the runners. Can be [restricted to a specific CIDR range](https://runs-on.com/networking/ssh/).
- **Static IPs** for your runners, if you [enabled private networking](https://runs-on.com/networking/static-ips/).
- Automatic [**cost and alert reporting**](https://runs-on.com/features/cost-and-alert-report/).
## Installation
RunsOn is available in 10 AWS regions. Use the [installation guide](https://runs-on.com/guides/install/) to set it up in 10 minutes.
## Usage
Before:
```yaml
runs-on: ubuntu-latest
```
After:
```yaml
runs-on:
- runs-on
- runner=2cpu-linux-x64
- run-id=${{ github.run_id }}
```
Learn more about all the supported [job labels](https://runs-on.com/configuration/job-labels) for dynamic runner configuration.
## Screenshots
**NodeJS CI build across different providers:**
**Stable queue time with thousands of jobs and bursts:**
**Much faster caches:**
**Metadata and timings about your job:**
## License
The code for the main repository (the current one, with the CloudFormation templates to deploy the AWS resources) is MIT licensed.
However the code in the `server/` submodule is proprietary and requires a license to use it:
- A non-profit (free) license is available if you are using RunsOn in a non-profit organization (this must apply to any parent organization as well), or if you are using it for personal use.
- For commercial organizations, you can evaluate for free for 15 days with a Demo license, after which you must buy a commercial license: 300€/year for the standard license, 1500€/year for the sponsorship license.
RunsOn has an insane ROI for commercial organizations. The monthly license cost is usually recouped within a few days. To learn more about licenses, visit the dedicated [pricing](https://runs-on.com/pricing/) page.
Access to the following code is public:
- CloudFormation template
- Public compatible AMIs for AWS
With a Sponsorship license, you get full access to the entire source code of RunsOn: server + agent (contained in the `server/` submodule), and can even modify it for internal use.
## Author
This software is built by [Cyril Rohr](https://cyrilrohr.com) - [Twitter/X](https://twitter.com/crohr).
Learn more about the [history](https://runs-on.com/about/) of the project.
If you like DevOps tooling, you might also be interested in my other projects [PullPreview.com](https://pullpreview.com) and [Packager.io](https://packager.io).