Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

TEP-0107: Implement Parameter Propagation #4845

Merged

Conversation

chitrangpatel
Copy link
Contributor

@chitrangpatel chitrangpatel commented May 6, 2022

Tekton Pipelines resources are verbose mostly because of explicitly propagating Parameters. Implicit Parameters feature was added to reduce the verbosity. However, there are challenges caused by mutating specifications to support Implicit Parameters. This PR builds on this prior work by propagating Parameters without mutating specifications to improve usability of Tekton Pipelines. This addresses features proposed in TEP-0107.

Changes

Submitter Checklist

As the author of this PR, please check off the items in this checklist:

  • Docs included if any changes are user facing
  • Tests included if any functionality added or changed
  • Follows the commit message standard
  • Meets the Tekton contributor standards (including
    functionality, content, code)
  • Release notes block below has been filled in
    (if there are no user facing changes, use release note "NONE")

Release Notes

Parameters are propagated in embedded specifications without mutations.

@tekton-robot tekton-robot added release-note Denotes a PR that will be considered when it comes time to generate release notes. needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. labels May 6, 2022
@tekton-robot
Copy link
Collaborator

Hi @chitrangpatel. Thanks for your PR.

I'm waiting for a tektoncd member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work. Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

@chitrangpatel chitrangpatel force-pushed the TEP-0107-Propagating-Parameters branch from 3f884da to b1e4824 Compare May 6, 2022 21:13
@tekton-robot tekton-robot removed the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label May 6, 2022
@chitrangpatel chitrangpatel force-pushed the TEP-0107-Propagating-Parameters branch from b1e4824 to be4850b Compare May 9, 2022 14:32
@dibyom
Copy link
Member

dibyom commented May 9, 2022

Hmmm...weird that we need an ok-to-test here given @chitrangpatel was added to the org in tektoncd/community#692

@afrittoli do you think our peribolos sync is broken?

@dibyom
Copy link
Member

dibyom commented May 9, 2022

/ok-to-test

@tekton-robot tekton-robot added ok-to-test Indicates a non-member PR verified by an org member that is safe to test. and removed needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. labels May 9, 2022
@tekton-robot
Copy link
Collaborator

The following is the coverage report on the affected files.
Say /test pull-tekton-pipeline-go-coverage to re-run this coverage report

File Old Coverage New Coverage Delta
pkg/apis/pipeline/v1beta1/task_validation.go 97.0% 97.1% 0.0
pkg/reconciler/pipelinerun/resources/apply.go 100.0% 91.0% -9.0
pkg/reconciler/taskrun/validate_resources.go 96.0% 96.9% 0.8

@dibyom
Copy link
Member

dibyom commented May 10, 2022

/assign @jerop

@jerop jerop changed the title TEP-0107: Propagating Parameters: Implemented implicit parameter propagation. TEP-0107: Propagating Parameters May 10, 2022
Copy link
Member

@jerop jerop left a comment

Choose a reason for hiding this comment

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

thank you @chitrangpatel!

please add tests for the changes in this PR - here are the guidelines for tests in tekton pipelines: https://github.com/tektoncd/community/blob/main/standards.md#tests

pkg/reconciler/pipelinerun/resources/apply.go Outdated Show resolved Hide resolved
@chitrangpatel chitrangpatel force-pushed the TEP-0107-Propagating-Parameters branch from be4850b to 14c67fa Compare May 10, 2022 18:41
@chitrangpatel
Copy link
Contributor Author

thank you @chitrangpatel!

please add tests for the changes in this PR - here are the guidelines for tests in tekton pipelines: https://github.com/tektoncd/community/blob/main/standards.md#tests

Thanks @jerop! I added examples and unit tests.

@afrittoli
Copy link
Member

Hmmm...weird that we need an ok-to-test here given @chitrangpatel was added to the org in tektoncd/community#692

@afrittoli do you think our peribolos sync is broken?

I don't see @chitrangpatel in the org - something went wrong with the CI job probably.
I sent an invite manually now.

We should add a nightly job to peribolos to make sure things stay in sync.

@jerop
Copy link
Member

jerop commented May 10, 2022

/retest

Copy link
Member

@jerop jerop left a comment

Choose a reason for hiding this comment

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

please add documentation as well

just to make sure this is not missed, are you planning to remove the existing implicit parameters in a follow up pr?

@tekton-robot
Copy link
Collaborator

The following is the coverage report on the affected files.
Say /test pull-tekton-pipeline-go-coverage to re-run this coverage report

File Old Coverage New Coverage Delta
pkg/apis/pipeline/v1beta1/task_validation.go 97.0% 97.1% 0.0
pkg/reconciler/pipelinerun/resources/apply.go 100.0% 99.1% -0.9
pkg/reconciler/taskrun/validate_resources.go 96.0% 96.9% 0.8

@chitrangpatel
Copy link
Contributor Author

chitrangpatel commented May 10, 2022

please add documentation as well

Yes, will do.

just to make sure this is not missed, are you planning to remove the existing implicit parameters in a follow up pr?

Are you referring to the alpha feature? Changes here? I'm a bit confused. I think I need to know what needs to be removed regarding existing implicit parameters. I guess, I can enable the alpha feature and see it for myself.

@chitrangpatel
Copy link
Contributor Author

/retest

@chitrangpatel chitrangpatel force-pushed the TEP-0107-Propagating-Parameters branch from 14c67fa to eb93c5f Compare May 11, 2022 18:10
@tekton-robot tekton-robot added the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label May 11, 2022
@dibyom
Copy link
Member

dibyom commented May 18, 2022

/retest

Tekton Pipelines resources are verbose mostly because of explicitly propagating Parameters. Implicit Parameters feature was added to reduce the verbosity. However, there are challenges caused by mutating specifications to support Implicit Parameters. This PR builds on this prior work by propagating Parameters without mutating specifications to improve usability of Tekton Pipelines. Removed existing implicit params behind alpha features. Parameter propagation is behind the `alpha` feature gate.
@chitrangpatel chitrangpatel force-pushed the TEP-0107-Propagating-Parameters branch from bfa2f34 to cbea59f Compare May 26, 2022 15:06
@chitrangpatel
Copy link
Contributor Author

@jerop test cases with parameter of type array to apply_test.go added.

@tekton-robot
Copy link
Collaborator

The following is the coverage report on the affected files.
Say /test pull-tekton-pipeline-go-coverage to re-run this coverage report

File Old Coverage New Coverage Delta
pkg/apis/pipeline/v1beta1/task_validation.go 97.7% 97.7% 0.0

@chitrangpatel
Copy link
Contributor Author

/test tekton-pipeline-unit-tests

Copy link
Member

@jerop jerop left a comment

Choose a reason for hiding this comment

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

thank you @chitrangpatel!

@tekton-robot
Copy link
Collaborator

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: jerop

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

The pull request process is described here

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 approved Indicates a PR has been approved by an approver from all required OWNERS files. label May 26, 2022
@jerop jerop changed the title Implement Parameter Propagation TEP-0107: Implement Parameter Propagation May 26, 2022
@jerop
Copy link
Member

jerop commented May 26, 2022

@tektoncd/core-maintainers please take a look 🙏🏾

@abayer
Copy link
Contributor

abayer commented May 26, 2022

/lgtm

@tekton-robot tekton-robot added the lgtm Indicates that a PR is ready to be merged. label May 26, 2022
@tekton-robot tekton-robot merged commit 30b2bcb into tektoncd:main May 26, 2022
jerop added a commit to jerop/community that referenced this pull request May 26, 2022
Marking TEP-0107 as implemented, thank you @chitrangpatel!

Pull Requests:
- tektoncd/pipeline#4906
- tektoncd/pipeline#4845
jerop added a commit to jerop/community that referenced this pull request May 26, 2022
Marking TEP-0107 as implemented, thank you @chitrangpatel!

Pull Requests:
- tektoncd/pipeline#4906
- tektoncd/pipeline#4845
jerop added a commit to jerop/community that referenced this pull request May 26, 2022
tekton-robot pushed a commit to tektoncd/community that referenced this pull request May 26, 2022
jerop added a commit to jerop/pipeline that referenced this pull request Jun 16, 2022
Propagated `Parameters` was designed and implemented to replace
Implicit `Parameters` to remove the mutation of specifications.
In this change, we update the alpha features table to remove the
Implicit `Parameters` and the broken link to its documentation,
and replace them with Propagated `Parameters`.

TEPs:
- https://github.com/tektoncd/community/blob/main/teps/0107-propagating-parameters.md
- https://github.com/tektoncd/community/blob/main/teps/0023-implicit-mapping.md

PRs:
- tektoncd#4906
- tektoncd#4845
jerop added a commit to jerop/pipeline that referenced this pull request Jun 17, 2022
Propagated `Parameters` was designed and implemented to replace
Implicit `Parameters` to remove the mutation of specifications.
In this change, we update the alpha features table to remove the
Implicit `Parameters` and the broken link to its documentation,
and replace them with Propagated `Parameters`.

TEPs:
- https://github.com/tektoncd/community/blob/main/teps/0107-propagating-parameters.md
- https://github.com/tektoncd/community/blob/main/teps/0023-implicit-mapping.md

PRs:
- tektoncd#4906
- tektoncd#4845
jerop added a commit to jerop/pipeline that referenced this pull request Jun 17, 2022
Propagated `Parameters` was designed and implemented to replace
Implicit `Parameters` to remove the mutation of specifications.
In this change, we update the alpha features table to remove the
Implicit `Parameters` and the broken link to its documentation,
and replace them with Propagated `Parameters`.

TEPs:
- https://github.com/tektoncd/community/blob/main/teps/0107-propagating-parameters.md
- https://github.com/tektoncd/community/blob/main/teps/0023-implicit-mapping.md

PRs:
- tektoncd#4906
- tektoncd#4845
tekton-robot pushed a commit that referenced this pull request Jun 17, 2022
Propagated `Parameters` was designed and implemented to replace
Implicit `Parameters` to remove the mutation of specifications.
In this change, we update the alpha features table to remove the
Implicit `Parameters` and the broken link to its documentation,
and replace them with Propagated `Parameters`.

TEPs:
- https://github.com/tektoncd/community/blob/main/teps/0107-propagating-parameters.md
- https://github.com/tektoncd/community/blob/main/teps/0023-implicit-mapping.md

PRs:
- #4906
- #4845
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. kind/feature Categorizes issue or PR as related to a new feature. lgtm Indicates that a PR is ready to be merged. ok-to-test Indicates a non-member PR verified by an org member that is safe to test. 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.

6 participants