waku-org
/
nwaku
mirror of https://github.com/waku-org/nwaku.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
nwaku/docs/contributors/release-process.md

3.3 KiB
Raw Blame History

Release Process

How to do releases.

For more context, see https://trunkbaseddevelopment.com/branch-for-release/

How to to do releases

Before release

Ensure all items in this list are ticked:

  • All issues under the corresponding release milestone has been closed or, after consultation, deferred to a next release.
  • All submodules are up to date.

    IMPORTANT: Updating submodules requires a PR (and very often several "fixes" to maintain compatibility with the changes in submodules). That PR process must be done and merged a couple of days before the release. In case the submodules update has a low effort and/or risk for the release, follow the "Update submodules" instructions. If the effort or risk is too high, consider postponing the submodules upgrade for the subsequent release or delaying the current release until the submodules updates are included in the release candidate.

Performing the release

  1. Checkout a release branch from master

git checkout -b release/v0.1

  1. Update CHANGELOG.md and ensure it is up to date

  2. Create a tag with the same name as release and push it

git tag -as v0.1 -m "Initial release."
git push origin v0.1

  1. Open a PR

  2. Harden release in release branch

    • Create a Github release on the release tag.
    • Add binaries for macos and ubuntu as release assets. Binaries can be compiled by triggering the "Upload Release Asset" workflow. Where possible, test the binaries before uploading to the release.

  3. Modify tag

If you need to update stuff, remove tag and make sure the new tag is associated with CHANGELOG update.

# Delete tag
git tag -d v0.1
git push --delete origin v0.1

# Make changes, rebase and tag again
# Squash to one commit and make a nice commit message
git rebase -i origin/master
git tag -as v0.1 -m "Initial release."
git push origin v0.1

After the release

  1. Announce the release on Twitter, Discord and other channels.
  2. Deploy the release:
    • Inform clients

    NOTE: known clients are currently using some version of js-waku, go-waku, nwaku or waku-rs. Clients are reachable via the corresponding channels on the Vac Discord server. It should be enough to inform clients on the #nwaku and #announce channels on Discord. Informal conversations with specific repo maintainers are often part of this process.

    • Deploy release to the wakuv2.prod fleet from Jenkins.
    • Ensure that nodes successfully start up and monitor health using Grafana and Kibana.
    • If necessary, revert by deploying the previous release. Download logs and open a bug report issue.
  3. Deploy release image to Dockerhub by triggering the same Jenkins job as before, but with the IMAGE_TAG set to the release tag (e.g. v0.10).