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: v2.6.0
HyperEnv supports minor version 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.
- Log in to the AWS Management Console.
- Open the AWS CloudFormation console.
- Select the HyperEnv stack, which is named
hyperenv-github-actions
in case you followed our documentation. - Go to the
Outputs
tab. - 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.
Identifier | Description | CloudFormation Template URL |
---|---|---|
public-vpc | Dedicated VPC with public subnets | https://s3.amazonaws.com/awsmp-fulfillment-cf-templates-prod/6652b15b-51a9-4d22-a90a-855988f37fed/6f4b4667453f4a378e92c3f373242a22.template |
byo-vpc | Bring Your Own VPC | https://s3.amazonaws.com/awsmp-fulfillment-cf-templates-prod/6652b15b-51a9-4d22-a90a-855988f37fed/1c2fe379fda74b7cb470d035296dd819.template |
Second, update the CloudForamtion stack to deploy the latest version.
- 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. - 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.
- Keep the defaults in Step 2 Specify stack details and press the Next button at the bottom of the page.
- Same for Step 3 Configure stack options. Keep the defaults and click the Next button.
- 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.
- Now, the stack is in status
UPDATE_IN_PROGRESS
. Typically, the update takes about five minutes. - Wait for the stack to reach status
UPDATE_COMPLETE
. You are now running the latest version of HyperEnv!
Are you upgrading from v1 to v2? Ensure to re-install the GitHub app as described below!
Are you upgrading from v1 to v2?
HyperEnv v1 (1.x.x) is using a backend and a public GitHub app to authenticate and authorize runners. With HyperEnv v2 (2.x.x) the public app and backend is no longer needed. The whole solution runs in your own AWS account which increases security and reliabilty.
However, it is necessary to install a private GitHub app after updating to 2.x.x as described in the following.
- Select the the CloudFormation stack
hyperenv-github-actions
and ensure it is in status UPDATE_COMPLETE. - Switch to the Outputs tab and search for the output named
NextStepUrl
and click the shown link.
By following the NextStepUrl
you will be guided through the process of installing the GitHub app next.