Changelog
Guides
Versions
v2.6.1
New stack parameters and best practices compliance changes. No longer defaults to fetching global config when a local repo config is not found. Improve housekeeping to handle an additional AWS internal error case when launching an instance.
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.6.1.yaml
v2.6.0
Auto-retry mechanism for spot interruptions, SingleAZ or MultiAZ NAT gateways, and more!
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.6.0.yaml
v2.5.9
Fix GitHub webhook custom_properties
handling when non-string values.
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.5.9.yaml
v2.5.8
Revert x/time dependency to v0.6.0 since v0.7.0 introduced a breaking change for rate-limits when using a zero limit.
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.5.8.yaml
v2.5.7
Add Private=only mode, make EBS encryption opt-in, introduce disk
label. Plus fixes and minor improvements.
Note: please use v2.5.8+ because this version embeds a dependency upgrade for the rate-limit library, which introduced a regression.
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.5.7.yaml
v2.5.6
Enable IPv6 for runners. Allow to specify multiple static IPs for the managed NAT gateway. Allow filtering images based on tags. A lot of changes (again) around GitHub rate-limit handling and housekeeping mechanism.
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.5.6.yaml
v2.5.5
Strengthen CF template configuration to better conform to AWS guidelines. Bug fixes.
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.5.5.yaml
v2.5.4
New ubuntu24 images, new housekeeping task to auto-restart instances that failed to launch, new always-on Private setting, additional runner details in logs, and more.
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.5.4.yaml
v2.5.2
Summary: refactor rate-limits, fix housekeeping behaviour, add missing cost allocation tags, fix rare preinstall bug, unregister runner from github after job termination.
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.5.2.yaml
v2.5.1
New ubuntu24 images, additional runner details in logs, scheduling retry mechanism if internal AWS server error when launching, and more.
Note: DO NOT USE this release. The new housekeeping behaviour is not working as expected.
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.5.1.yaml
v2.5.0
Summary: Allow to assign an environment name to each RunsOn stack. Allow to specify VPC CIDR block and export outputs to facilitate VPC peering connections. Allow to set custom tags on instances.
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.5.0.yaml
v2.4.0
Summary: beta windows support, prometheus metrics, disk statistics in workflow logs.
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.4.0.yaml
v2.3.2
Summary: a fix for useless creation of instances when hitting quota errors, reverting the unbounded cpu
and ram
change (from v2.3.0), and CloudWatch agent now streams instance logs into CloudWatch.
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.3.2.yaml
v2.3.1
Summary: Auto-mounting of ephemeral disks, improvements in dangling instance cleanup, better handling of preinstall
.
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.3.1.yaml
v2.3.0
Summary: Allow setting custom spot allocation strategy, cpu
and ram
behaviour change, config file is now read from the current branch for private repositories. And 2 new regions!
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.3.0.yaml
v2.2.4
Summary: properly handle jobs with environments attached.
Note: this newer version requires a permission update for the accompanying GitHub app. You will receive an email after the upgrade with instructions on how to make the change. If you do nothing, RunsOn will still work, but the fix below will not be active.
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.2.4.yaml
v2.2.3
Summary: make volume network throughput configurable, reduce alert noise for spot quota exceeded. And 1 new region!
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.2.3.yaml
v2.2.2
Summary: Add more tags to EC2 instances, and many fixes. Plus 2 new regions!
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.2.2.yaml
v2.2.1
Summary: fix _extends
handling in config file.
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.2.1.yaml
v2.2.0
Summary: Private subnet support, new retry mechanism, spot interruption detection, bare-metal support, and many fixes and improvements.
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.2.0.yaml
v2.1.0
Summary: full rewrite in Go, use external FIFO queue to keep jobs in flight.
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.1.0.yaml
v2.0.13
Summary: switch to CreateFleet
API, multi-az support, multi-region support + many fixes.
Warning: this is a major release bump, with a new VPC being created. You are advised to upgrade either during a quiet time (no runner running, otherwise the old VPC cannot be destroyed), or simply create a new stack with that template, follow the configuration process, and then Pause
the previous AppRunner service until you validate that everything is going fine. Doing it this way will allow you to easily roll back to the previous version by just removing the new stack and clicking Resume
on the previous AppRunner service.
- Released on: .
- For more details: view release notes on GitHub.
- CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.0.13.yaml
v1.7.4
Summary: handle conflict when registering runner.
- Released on: .
- For more details: view release notes on GitHub.
v1.7.3
Summary: Reduce rate-limit issues, add m7i
as additional family type for default runners. Plus 2 new regions!
- Released on: .
- For more details: view release notes on GitHub.
v1.7.2
Summary: IMDSv2 support, instant reload after first setup, add tags on instance and publish metrics.
- Released on: .
- For more details: view release notes on GitHub.
v1.6.5
Summary: better error message when trying to launch EC2 instance.
- Released on: .
- For more details: view release notes on GitHub.
v1.6.4
Summary: fix race-condition when updating the stack.
- Released on: .
- For more details: view release notes on GitHub.
v1.6.3
Summary: Fix error message when unable to launch a runner.
- Released on: .
- For more details: view release notes on GitHub.
v1.6.2
Summary: avoid EC2 rate-limit issues.
- Released on: .
- For more details: view release notes on GitHub.
v1.6.1
Summary: Support for S3 backend for storing caches. New ubuntu22-full-arm64
image.
- Released on: .
- For more details: view release notes on GitHub.