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

Release v1.19.5+suite.1

The next suite version v1.19.5+suite.1 is planned for release in Jun 2023.

The target dates are as follows:

  • Kick off held May 31, 2023.
  • Hand off to Technical Writers by Jun 16, 2023.
  • Release by Jun 23, 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):

    • cyberark/conjur-openapi-spec
    • cyberark/conjur-puppet
    • cyberark/secretless-broker
    • cyberark/secrets-provider-for-k8s

  • 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.5
    • cyberark/conjur-cli-go - 8.0.10 (after fixing snyk vulns)
    • cyberark/conjur-api-go - 0.11.1 (investigate fixing synk vulns w/ golang alpine image)
    • cyberark/conjur-api-java - 3.0.5 (investigate fixing synk vulns)
    • cyberark/conjur-api-ruby - 5.4.1 (conditionally, if bundle update produces major updates)
    • cyberark/cloudfoundry-conjur-buildpack - 2.2.8
    • cyberark/conjur-service-broker - 1.2.10 (after fixing snyx vulns)
    • cyberark/conjur-authn-k8s-client - 0.25.1
    • cyberark/secrets-provider-for-k8s - 1.5.1
    • cyberark/terraform-provider-conjur - 0.6.6
    • cyberark/summon - 0.9.6 (investigate using golang alpine to fix snyk)
    • cyberark/summon-conjur - 0.7.1

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

    Docs issue: CNJR-1830

  • 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/268

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.