Skip to main content

Release Process

Airy Core follows a scheduled release process: we release a new version every week. This approach allows us to ship smaller releases which ease the risk of breaking changes and brings new features and bug-fixes to our users in a timely manner.


The release scripts needs a GITHUB_TOKEN environment variable with write permission to the Airy organization to function correctly

Standard release

Once a release day comes, we execute the following steps:

  • We run ./scripts/ start x.y.z
  • We wait for the release candidate CLI to be pushed and then download it by running:
    • wget$VERSION-rc/darwin/amd64/airy
    • chmod +x airy
  • We test the release using ./airy create --provider=minikube.
  • We run the Cypress tests with the command ./node_modules/.bin/cypress open -C integration/cypress.config.ts
  • Any additional fix is committed directly to the release branch. Then we must wait for all the images to be pushed via CI and test again.
  • Once we're satisfied with the release we execute the following steps:
    • We create the draft release through the CI which used for the Changelog ./scripts/ changelog x.y.z.
    • We clean up the draft release once it is there.
    • If the upgrade to the new version requires manual steps, we detail them.
    • We run ./scripts/ finish x.y.z
    • We update the version string to x.y.z and the sha to in the Homebrew Formula for the CLI
    • We archive cards in the done column of the work in progress board
    • We make sure the changelog in the docs has been updated
    • We publish the release and announce it!

As part of the release process we are also releasing a command line client - the Airy CLI.

You can check out existing releases on GitHub.

Hotfix release

In case we need to hotfix a release, we follow a different process. At the moment, the process is completely manual and goes as follows:

  • Create a new branch from main called hotfix/description-of-the-fix
  • Test the hotfix
  • Write a custom release draft
  • Update the changelog (using ./scripts/
  • Update VERSION file
  • Merge to main and develop (keep the VERSION file in develop at *-alpha)
  • Publish the draft
  • Announce the hotfix