Changelog

Note

RunsOn optimizes your CI/CD workflows by launching ephemeral EC2 instances in your AWS account in response to GitHub Action events. It’s not a SaaS, but a self-contained solution that runs within your private AWS environment.

Get updates on new features and improvements for RunsOn:

Email address

Get updates

Guides

Install

Upgrade

Downgrade

Troubleshoot

Versions

v2.6.3

Fix magic cache handling of actions/upload-artifact. Prepare for RunsOn CLI.

• Released on: 2024-12-19T15:16:46Z.
• For more details: view release notes on GitHub.
• CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.6.3.yaml

v2.6.2

Magic transparent cache for dependencies and docker layers. SSM support for logging into runner instances. And more.

• Released on: 2024-12-12T15:33:08Z.
• For more details: view release notes on GitHub.
• CloudFormation template: https://runs-on.s3.eu-west-1.amazonaws.com/cloudformation/template-v2.6.2.yaml

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: 2024-11-27T16:07:46Z.
• 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: 2024-11-21T13:55:48Z.
• 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: 2024-11-06T10:51:52Z.
• 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: 2024-10-30T21:12:19Z.
• 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: 2024-10-25T16:55:41Z.
• 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: 2024-10-18T08:47:12Z.
• 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: 2024-10-16T17:04:54Z.
• 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: 2024-09-25T15:16:35Z.
• 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: 2024-09-19T09:23:54Z.
• 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: 2024-09-13T15:24:28Z.
• 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: 2024-08-28T07:50:30Z.
• 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: 2024-08-01T19:59:22Z.
• 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: 2024-06-21T12:07:10Z.
• 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: 2024-06-19T14:31:22Z.
• 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: 2024-06-13T07:54:13Z.
• 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: 2024-05-23T20:32:44Z.
• 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: 2024-05-17T12:38:48Z.
• 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: 2024-04-28T10:48:44Z.
• 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: 2024-04-16T19:01:13Z.
• 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: 2024-04-11T13:16:45Z.
• 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: 2024-04-03T11:06:06Z.
• 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: 2024-03-27T11:07:01Z.
• 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: 2024-03-14T09:03:41Z.
• 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: 2024-03-12T19:41:00Z.
• 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: 2024-03-10T13:25:39Z.
• For more details: view release notes on GitHub.

v1.6.5

Summary: better error message when trying to launch EC2 instance.

• Released on: 2024-02-23T16:10:23Z.
• For more details: view release notes on GitHub.

v1.6.4

Summary: fix race-condition when updating the stack.

• Released on: 2024-02-23T08:08:14Z.
• For more details: view release notes on GitHub.

v1.6.3

Summary: Fix error message when unable to launch a runner.

• Released on: 2024-02-21T13:31:11Z.
• For more details: view release notes on GitHub.