Skip to content

RELEASING.md

Latest commit

 

History

History
56 lines (42 loc) · 3.3 KB

RELEASING.md

File metadata and controls

56 lines (42 loc) · 3.3 KB

Releasing Ambassador

If you just want to use Ambassador, check out https://www.getambassador.io/! You don't need to build - much less release! - anything, and in fact you shouldn't.

If you don't work at Datawire, this document is probably not going to help you. Maybe check out the developer guide instead.

If you're still reading, you must be at Datawire. Congrats, you picked a fine place to work! To release Ambassador, you'll need credentials for our Github repos.

  1. PRs will pile up on master. Don't accept PRs for which CI doesn't show passing tests.

  2. Once master has all the release drivers, tag master with an RC tag, e.g. 0.33.0-rc1.

  3. The RC tag will trigger CI to run a new build and new tests. It had better pass: if not, figure out why.

  4. The RC build will be available as e.g. quay.io/datawire/ambassador:0.33.0-rc1 and also as e.g. quay.io/datawire/ambassador:0.33.0-rc-latest. Any other testing you want to do against this image, rock on.

  5. When you're happy with everything, sync up the docs!

    • make pull-docs to pull updates from the docs repo
    • Handle conflicts as needed.
    • Commit any conflict-resolution changes to master.

  6. After the docs are synced, use make release-prep to update CHANGELOG.md and docs/versions.yml.

    • It will commit, but not push, the updated files. Make sure the diffs it shows you look correct!
    • Do a manual git push to update the world with your new files.
    • It is critical to update docs/versions.yml so that everyone gets the new version.

  7. Now for the time-critical bit.

    • Tag master with a GA tag like 0.33.0 and let CI do its thing.
    • CI will retag the latest RC image as the GA image.
    • make push-docs after the retag to push new docs out to the website.

    Note that there must be at least one RC build before a GA, since the GA tag does not rebuild the docker images -- it retags the ones built by the RC build. This is intentional, to allow for testing to happen on the actual artifacts that will be released.

  8. Submit a PR into the helm/charts repo to update things in stable/ambassador:

    • in Chart.yaml, update appVersion with the new Ambassador version, and bump version.
    • in README.md, update the default value of image.tag.
    • in values.yaml, update tag.
    • Helpful stuff for this:
      • git checkout master # switch to master
      • git fetch --all --prune # make sure our view of remotes is up to date
      • git pull # pull down any changes to master
      • git rebase upstream/master # move master on top of upstream
      • git push # push rebases to our fork
      • git checkout -b update/$VERSION # switch to a feature branch
      • make your edits
      • git commit -a # commit changes -- don't forget DCO in the message!
      • git push origin update/$VERSION # push to feature branch
      • open a PR
    • Once your PR is merged, delete the feature branch without merging it back to origin/master.

  9. Additional updates: