Skip to content

Latest commit

 

History

History
23 lines (21 loc) · 1.57 KB

RELEASE.md

File metadata and controls

23 lines (21 loc) · 1.57 KB

Jaeger Backend Release Process

  1. Create a PR "Preparing release X.Y.Z" against master or maintenance branch (example) by updating CHANGELOG.md to include:
    • A new section with the header <X.Y.Z> (YYYY-MM-DD)
    • A curated list of notable changes and links to PRs. Do not simply dump git log, select the changes that affect the users. To obtain the list of all changes run make changelog.
    • The section can be split into sub-section if necessary, e.g. UI Changes, Backend Changes, Bug Fixes, etc.
    • If the submodules have new releases, please also upgrade the submodule versions then commit, for example:
      cd jaeger-ui
      git ls-remote --tags origin
      git fetch
      git checkout {new_version} //e.g. v1.5.0
      
  2. Add all merged pull requests to the milestone for the release and create a new milestone for a next release e.g. Release 1.16.
  3. After the PR is merged, create a release on Github:
    • Title "Release X.Y.Z"
    • Tag vX.Y.Z (note the v prefix) and choose appropriate branch
    • Copy the new CHANGELOG.md section into the release notes
  4. The release tag will trigger a build of the docker images
  5. Once the images are available on Docker Hub, announce the release on the mailing list, gitter, and twitter.
  6. Publish documentation for the new version in jaegertracing.io.

Maintenance branches should follow naming convention: release-major.minor (e.g.release-1.8).