Skip to content

Commit

Permalink
TEP-0059: Skipping Strategies - Migration Plan
Browse files Browse the repository at this point in the history
This change is a clarification and update to the migration and upgrade
plan for skipping strategies.

The implementable proposal is to change the scope of `when` expressions
to guard the `Task`. This is a backwards-incompatible change. To make the
transition smooth, we plan to:
- provide a feature flag, `scope-when-expressions-to-task`, which:
  - will default to `scope-when-expressions-to-task` : "false" to guard
  a `Task` and its dependent `Tasks`
  - can be set to `scope-when-expressions-to-task` : "true" to guard a
  `Task` only
- after 9 months, per the [Tekton API compatibility policy](https://github.com/tektoncd/pipeline/blob/main/api_compatibility_policy.md#alpha-beta-and-ga),
  we'll flip the feature flag and default to `
  scope-when-expressions-to-task` : "true" [February 2022]
- in the next release, we'll remove the feature flag and `when` expressions
 will be scoped to guard a `Task` only going forward [March 2022]
- when we do [v1 release](tektoncd/pipeline#3548)
(projected for early 2022), we will have `when` expressions guarding a
`Task` only both in _beta_ and _v1_

We also plan to over-communicate during the migration in Slack, email
and working group meetings.
  • Loading branch information
jerop committed Jul 20, 2021
1 parent 7b4fc47 commit 8acaee3
Showing 1 changed file with 9 additions and 6 deletions.
15 changes: 9 additions & 6 deletions teps/0059-skipping-strategies.md
Original file line number Diff line number Diff line change
Expand Up @@ -568,12 +568,15 @@ behavior or add a feature that may replace and deprecate a current one.

Changing the scope of `WhenExpressions` to guard the `Task` only is backwards-incompatible, so to make the
transition smooth:
- we'll provide a feature flag, `set-when-expressions-scope-to-task`, which:
- will default to `set-when-expressions-scope-to-task` : `false` to guard a `Task` and its dependent `Tasks`
- can be set to `set-when-expressions-scope-to-task` : `true` to guard a `Task` only
- after 9 months, we'll flip the feature flag and default to `set-when-expressions-scope-to-task` : `true`
- after 9 more months, we'll remove the feature flag and `WhenExpressions` will be scoped to guard a `Task` only going
forward
- we'll provide a feature flag, `scope-when-expressions-to-task`, which:
- will default to `scope-when-expressions-to-task` : "false" to guard a `Task` and its dependent `Tasks`
- can be set to `scope-when-expressions-to-task` : "true" to guard a `Task` only
- after 9 months, per the [Tekton API compatibility policy](https://github.com/tektoncd/pipeline/blob/main/api_compatibility_policy.md#alpha-beta-and-ga),
we'll flip the feature flag and default to `scope-when-expressions-to-task` : `true` [February 2022]
- in the next release, we'll remove the feature flag and `WhenExpressions` will be scoped to guard a
`Task` only going forward [March 2022]
- when we do [v1 release](https://github.com/tektoncd/pipeline/issues/3548) (projected for early 2022), we will have
`when` expressions guarding a `Task` only both in _beta_ and _v1_

We will over-communicate during the migration in Slack, email and working group meetings.

Expand Down

0 comments on commit 8acaee3

Please sign in to comment.