Upgrade Guide

We regularly release new versions of HyperEnv for GitHub Actions Runner to add features, improve performance, or patch vulnerabilities (see our release notes).

The latest versions is: v1.8.0

HyperEnv supports updates without downtime. You don’t need to be afraid of updating HyperEnv, even while jobs are running.

How to upgrade HyperEnv for GitHub Actions Runner to the latest version?

First, you need to find out the fulfillment option you are using: Bring Your Own VPC or Dedicated VPC with public subnets.

1. Log in to the AWS Management Console.
2. Open the AWS CloudFormation console.
3. Select the HyperEnv stack, which is named hyperenv-github-actions in case you followed our documentation.
4. Go to the Outputs tab.
5. Search for the value of the output FulfillmentOption.

The following table maps the output values with a description and a CloudFormation template URL. Copy the CloudForamtion template URL, you will need it in the next step.

public-vpc	Dedicated VPC with public subnets	https://s3.amazonaws.com/awsmp-fulfillment-cf-templates-prod/6652b15b-51a9-4d22-a90a-855988f37fed/02082b13799242eca319c2b54904f7eb.template
byo-vpc	Bring Your Own VPC	https://s3.amazonaws.com/awsmp-fulfillment-cf-templates-prod/6652b15b-51a9-4d22-a90a-855988f37fed/272dbcb0eb254eb48712baa477cf1cef.template

Second, update the CloudForamtion stack to deploy the latest version.

1. Select the HyperEnv stack, which is named hyperenv-github-actions in case you followed our documentation, and press the Update button as shown in the following screenshot.
2. Select the Replace current template option. Copy and paste the CloudFormation template URL from step one into the Amazon S3 URL input field. Click the Next button.
3. Keep the defaults in Step 2 Specify stack details and press the Next button at the bottom of the page.
4. Same for Step 3 Configure stack options. Keep the defaults and click the Next button.
5. Review the details shown in Step 4 Review, confirm I acknowledge that AWS CloudForamtion might create IAM resources. and press the Submit button as illustrated in the following screenshot.
6. Now, the stack is in status UPDATE_IN_PROGRESS. Typically, the update takes about five minutes.
7. Wait for the stack to reach status UPDATE_COMPLETE. You are now running the latest version of HyperEnv!