Skip to content

Conversation

@anithapriyanatarajan
Copy link

@anithapriyanatarajan anithapriyanatarajan commented Dec 18, 2025

Changes

This pull request updates the Tekton Results release process by introducing a new publish-release Tekton Task and updating the release documentation. The changes streamline the release workflow in line with other tektoncd components. The documentation now includes new prerequisites, environment variable conventions, improved branching guidance, and additional post-release steps.

Key changes include:

1. New Tekton Task for Publishing Releases

  • Added tekton/publish.yaml, defining a comprehensive publish-release Tekton Task. This task automates container image publishing, registry authentication, image tagging, and release YAML generation, supporting multi-platform builds and regional registries.

2. Major Improvements to Release Documentation

  • Rewrote tekton/release-cheatsheet.md for clarity and completeness:
    • Added installation steps for required tools (rekor, kustomize), and clarified environment variable usage via a release.env file.
    • Updated instructions for selecting commits, running the release pipeline, and handling backports. Provided explicit tkn commands with new parameters and workspace conventions.
    • Expanded post-release steps: finding Rekor UUIDs, running the draft release pipeline, creating release branches, updating documentation, testing releases, and announcing in relevant Slack channels. Added guidance for updating the catalog, plumbing, and website repositories.
    • Added instructions for configuring kubectl for the dogfooding cluster, including Oracle Cloud CLI usage.

Submitter Checklist

These are the criteria that every PR should meet, please check them off as you review them:

  • Has Docs included if any changes are user facing
  • Has Tests included if any functionality added or changed
  • Tested your changes locally (if this is a code change)
  • Follows the commit message standard
  • Meets the Tekton contributor standards (including functionality, content, code)
  • Has a kind label. You can add a comment on this PR that contains /kind <type>. Valid types are bug, cleanup, design, documentation, feature, flake, misc, question, tep
  • Release notes block below has been updated with any user-facing changes (API changes, bug fixes, changes requiring upgrade notices or deprecation warnings)
  • Release notes contain the string "action required" if the change requires additional action from users switching to the new release

Release Notes

/kind cleanup

@tekton-robot tekton-robot added kind/cleanup Categorizes issue or PR as related to cleaning up code, process, or technical debt. release-note Denotes a PR that will be considered when it comes time to generate release notes. labels Dec 18, 2025
@tekton-robot tekton-robot requested review from dibyom and khrm December 18, 2025 11:07
@tekton-robot
Copy link

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
To complete the pull request process, please assign khrm after the PR has been reviewed.
You can assign the PR to them by writing /assign @khrm in a comment when ready.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@tekton-robot tekton-robot added the size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. label Dec 18, 2025
@anithapriyanatarajan
Copy link
Author

cc: @enarha

Copy link
Contributor

@enarha enarha left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I went through the change and I have few comments. As discussed offline, we might keep this PR open until the next release where we can use the new instructions and jobs to confirm they work and only merge the PR then.

VERSION_TAG=# UPDATE THIS. Example: v0.5.0
RELEASE_GIT_SHA=# SHA of the release to be released
cat <<EOF > release.env
TEKTON_VERSION= # Example: v0.69.0
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is a bit confusing, the name of the var and the example value. Isn't this about Results? I understand we want it generic, but it is just confusing. And the example version as well, given that currently Results is in version v0.17.x., we can make it v0.17.0 so similar, but not something that looks so much in the future.

TEKTON_VERSION= # Example: v0.69.0
TEKTON_RELEASE_GIT_SHA= # SHA of the release to be released, e.g. 5b082b1106753e093593d12152c82e1c4b0f37e5
TEKTON_OLD_VERSION= # Example: v0.68.0
TEKTON_RELEASE_NAME="naming pattern" # Name of the release
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we do not have this for any other component apart from Pipeline maybe. What happens if it is not set?

1. Execute the Draft Release task.
1. The YAMLs are now released! Anyone installing Tekton Results will get the new version. Time to create a new GitHub release announcement:
1. Find the Rekor UUID for the release
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unfortunately we still do not have that for Results. We have two open issues to fix it: #442 and #525 . They are quite old, maybe it's just about time to fix that. We can keep that in the doc with some remark that the above issues have to be resolved first and we should skip the section until that happens.

cat /workspace/.ko.yaml
- name: run-ko
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am not sure whether this step is correct or not. I think we aren't taking into account 'kustomise'.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

kind/cleanup Categorizes issue or PR as related to cleaning up code, process, or technical debt. release-note Denotes a PR that will be considered when it comes time to generate release notes. size/XL Denotes a PR that changes 500-999 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants