v1.19.2 suite.1 - cyberark/conjur-oss-suite-release GitHub Wiki

Release v1.19.2+suite.1

The next suite version v1.19.2+suite.1 is planned for release in Feb 2023.

The target dates are as follows:

  • Kick off held Jan 25, 2023.
  • Hand off to Technical Writers by Feb 20, 2023.
  • Release by Feb 27, 2023.

Release Checklist

Prepare New Release

  • Check the Jenkins dashboard to ensure builds are green.

  • If any builds have recently not been green, review the project and determine whether updates are required pre-release.

    Components requiring updates pre-suite release (with issue links):

  • Review the unreleased changes in the wiki. Determine whether any additional releases will be required before creating a new suite release.

    Components requiring releases pre-suite release:

    • cyberark/conjur - 1.19.2
    • cyberark/conjur-api-python - 0.1.0
    • cyberark/conjur-api-java - 3.0.4 (make sure security fix is in)
    • cyberark/conjur-api-go - 0.11.0 (make sure security fix is in)
    • cyberark/conjur-cli-go - 8.0.4
    • cyberark/terraform-provider-conjur - 0.6.5
    • cyberark/secretless-broker - 1.7.16 (make sure security fix is in)
    • cyberark/conjur-service-broker - 1.2.8
    • cyberark/cloudfoundry-conjur-buildpack - 2.2.7 (make sure security fix is in)

  • Create a docs issue to add a new OSS suite release.

    Docs issue: CNJR-315

  • Create a PR to update the suite.yml to include updated versions. Include a draft of the markdown release notes by running the following command in your release branch:

    summon -p keyring.py \
  --yaml 'GITHUB_TOKEN: !var github/api_token' \
  ./parse-changelogs \
  -v {suite release version} \
  -t release \
  -o RELEASE_NOTES.md

    PR link: https://github.com/cyberark/conjur-oss-suite-release/pull/262

Definition of Done & Release Notes

  • Conjur product owner reviews and approves the PR. All changes are:
    • Complete and usable by users
    • Documented
  • Conjur product engineering manager reviews the PR and adds "What's new" text in a comment.
  • PR is updated to include "What's new" text.
  • Conjur maintainer reviews and approves the PR, ensuring the PR checklist is complete for a release.
  • Conjur maintainer merges the PR and creates a tag.
  • Conjur maintainer copies the HTML release notes from the draft release to the docs issue.

Finalize Release

  • Technical writers publish the release notes.
  • Conjur maintainer publishes the draft GitHub release.