Skip to content

Latest commit

 

History

History
47 lines (28 loc) · 3.43 KB

how-to-make-releases.md

File metadata and controls

47 lines (28 loc) · 3.43 KB
Raw

Releasing a new Hyperlight version to Cargo

This document details the process of releasing a new version of Hyperlight to crates.io. It's intended to be used as a checklist for the developer doing the release. The checklist is represented in the below sections.

Update Cargo.toml Versions

Currently, we need to manually update the workspace Cargo.toml version number to match to whatever release we are making. This will affect the version of all the crates in the workspace.

Note: we'll use v0.4.0 as the version for the above and all subsequent instructions. You should replace this with the version you're releasing. Make sure your version follows SemVer conventions as closely as possible, and is prefixed with a v character. In particular do not use a patch version unless you are patching an issue in a release branch, releases from main should always be minor or major versions.

Create a PR with this change and merge it into the main branch.

Create a tag

When the above PR has merged into main branch you should create a tag. Make sure you have pulled the recently updated main branch, and do the following on the main branch:

git tag -a v0.4.0 -m "A brief description of the release"
git push origin v0.4.0 # if you've named your git remote for the hyperlight-dev/hyperlight repo differently, change 'origin' to your remote name

If you are creating a patch release see the instructions here.

Create a release branch (no manual steps)

After you push your new tag in the previous section, the "Create a Release Branch" CI job will automatically run. When this job completes, a new release/v0.4.0 branch will be automatically created for you.

Create a new GitHub release

After the previous CI job runs to create the new release branch, go to the "Create a Release". GitHub actions workflow and do the following:

  1. Click the "Run workflow" button near the top right
  2. In the Use workflow from dropdown, select the release/v0.4.0 branch
  3. Click the green Run workflow button

Note: In case you see a "Create a Release" job already running before starting this step, that is because the "Create a Release" workflow also automatically runs on push to main branch to create a pre-release. You must still do the steps outlined above.

When this job is done, a new GitHub release will be created for you. This job also publishes the following rust packages to the crates.io:

  • hyperlight-common
  • hyperlight-guest
  • hyperlight-host

Patching a release

If you need to update a previously released version of Hyperlight then you should open a Pull Request against the release branch you want to patch, for example if you wish to patch the release v0.4.0 then you should open a PR against the release/v0.4.0 branch.

Once the PR is merged, then you should follow the instructions above. In this instance the version number of the tag should be a patch version, for example if you are patching the release/v0.4.0 branch and this is the first patch release to that branch then the tag should be v0.4.1. If you are patching a patch release then the tag should be v0.4.2 and the target branch should be release/v0.4.1 and so on.