HyperCube uses a channel-oriented, date-based branching process described here.
When cutting a new channel branch these pre-steps are required:
- Pick your branch point for release on master.
- Create the branch. The name should be "v" + the first 2 "version" fields from Cargo.toml. For example, a Cargo.toml with version = "0.9.0" implies the next branch name is "v0.9".
- Update Cargo.toml to the next semantic version (e.g. 0.9.0 -> 0.10.0).
- Push your new branch to hypercube.git
- Land your Carto.toml change as a master PR.
At this point, ci/channel-info.sh should show your freshly cut release branch as "BETA_CHANNEL" and the previous release branch as "STABLE_CHANNEL".
We use github's Releases UI for tagging a release.
- Go there ;).
- Click "Draft new release".
- If the first major release on the branch (e.g. v0.8.0), paste in this template and fill it in.
- Test the release by generating a tag using semver's rules. First try at a release should be .X-rc.0.
- Verify release automation:
- Crates.io should have an updated HyperCube version.
- ...
- After testnet deployment, verify that testnets are running correct software. http://metrics.hypercube-lab.org should show testnet running on a hash from your newly created branch.