Tekton Pipeline release v0.11.3 "Ragdoll Norby"

🎉 Timeout and Result Fixes 🎉

-Docs @ v0.11.3
-Examples @ v0.11.3

0.11.3 is likely to be the final patch release before 0.12. Included here is a fix for Timeouts in PipelineTasks and several fixes for Task Results. This release also adds support for using Task Results in the parameters of Conditions.

Upgrade Notices

🚨 If you are upgrading from a version of Tekton Pipelines older than v0.11.0 then you may need to delete your existing tekton-pipeline deployments before applying v0.11.3.

Changes

Fixes

• 🐛 Fix 3 bugs with Task Results #2471
• 🐛 Fix PipelineTask timeout not correctly set #2468

Thanks

Thanks to these contributors who contributed to v0.11.3!

• ❤️ @bobcatfish
• ❤️ @othomann
• ❤️ @vdemeester

Tekton Pipeline release v0.11.2 "Ragdoll Norby"

🎉 Docs and Misc Fixes 🎉

-Docs @ v0.11.2
-Examples @ v0.11.2

Upgrade Notices

🚨 If you are upgrading from a version of Tekton Pipelines older than v0.11.0 then you may need to delete your existing tekton-pipeline deployments before applying v0.11.2.

Changes

Misc

• 🔨 Mark PipelienResourceBinding as inlined 🏑 #2359
• 🔨 e2e tests - use helm v3 #2368

Docs

• 📖 Rewrite the Tasks documentation for clarity and flow. #2317
• 📖 Doc about migrating from v1alpha1 to v1beta1 #2231
• 📖 Add link from migrate doc to GCS task in catalog #2350
• 📖 Add a link to the v1alpha1 migration doc #2351
• 📖 Add a link to the Workspaces doc from docs/README.md #2352
• 📖 Document Tekton's Many Variables #2358
• 📖 Rewrite the Pipelines documentation for clarity and flow. #2355

Thanks

Thanks to these contributors who contributed to v0.11.2!

• @sergetron
• @vdemeester
• @eddycharly
• @sbwsg

Tekton Pipeline release v0.11.1 "Ragdoll Norby"

🎉 Beta Bug Bash 1 🎉

This release fixes a bug with default timeouts. The default-timeout-minutes field in the config-defaults ConfigMap was being ignored. Upgrade to this release to have the default timeout respected in TaskRuns and PipelineRuns again.

-Docs @ v0.11.1
-Examples @ v0.11.1

Upgrade Notices

🚨 If you are upgrading from a version of Tekton Pipelines older than v0.11.0 then you may need to delete your existing tekton-pipeline deployments before applying v0.11.1.

Changes

Fixes

• 🐛 Fix default-timeout from config not correctly set (#2333)

Known Issues

• ⚠️ Cancelling PipelineRuns does not work properly in this release. A cancelled PipelineRun should cancel any of its executing TaskRuns. However, currently, any TaskRuns that are executing when a PipelineRun is cancelled will continue until they exit on their own. Follow Issue 2337 for updates.

Thanks

Thanks to these contributors who contributed to v0.11.1!

• ❤️ @vdemeester

Tekton Pipelines Beta release v0.11.0 "Ragdoll Norby"

🎉 Tekton Pipelines Beta 🎉

This release is the first official Tekton Pipelines Beta.

If you've been following along with prior release candidates there have been no code changes since yesterday's release of RC4. The only noticeable change is that applying the latest version of Tekton to your clusters will now yield a controller with version label of "v0.11.0" instead of "v0.11.0-rc4".

Installation one-liner:

kubectl apply -f https://storage.googleapis.com/tekton-releases/pipeline/previous/v0.11.0/release.yaml

• Docs @ v0.11.0
• Examples @ v0.11.0

Upgrade Notices

🚨 The minimum version of Kubernetes required to run Tekton Pipelines is now 1.15.

🚨 If you are upgrading from an older version of Tekton Pipelines you may need to delete your existing tekton-pipeline deployments before applying v0.11.0.

🚨 Submitting the same v1alpha1 Tasks more than once results in errors. Use kubectl replace instead of kubectl apply.

Deprecation Notices

• 🚨 PipelineResources are not moving to Beta with Tekton's other types

  We do not plan to promote PipelineResources into Beta. They will continue to work as part of Beta but their use is discouraged when possible. We are progressively adding documentation and Catalog Tasks to help users migrate away from them:

  • The git-clone Task in the catalog performs the same work as the Git PipelineResource.
  • The pullrequest Task in the catalog performs the same work as the PullRequest PipelineResource.
  • Workspaces are intended for sharing files between Tasks.

• 🚨 The $HOME env var and workingDir of Steps will change in the next release (#2044)

  Tekton currently overwrites the HOME environment variable in a Step's container to always be /tekton/home and the workingDir field of the Step's image to always be /workspace. This behaviour will change in the next release: those two fields will be left untouched by Tekton, using whatever settings are defined in the container image and Task's YAML. We have introduced a new ConfigMap, named feature-flags, that allows you to use this new behaviour now:

  • disable-home-env-overwrite: When this flag is set to "true" Tekton will allow a Step's image to dictate its own $HOME directory.
  • disable-working-directory-overwrite: When this flag is set to "true" Tekton will allow a Step's image to dictate its own workingDir.

  In the next release we plan to flip these flags so that they are opt-out rather than opt-in. At some point in the future we plan to remove support for this overwriting behaviour entirely.

Changes

Below is the complete list of changes that have been added to Tekton Pipelines across all of the Beta Release Candidates.

Features

• ✨ Introduce the v1beta1 API Version (#2035)
• ✨ Improved LimitRange support (#2020)
• ✨ Pipeline Resources can now be marked as optional (#1910)
• ✨ Data can now be shared between Tasks using Task Results and Task Params (#1921)
• ✨ Tekton Pipelines can be configured to no longer overwrite the HOME environment variable and workingDir of Steps (#2044)
• ✨ Sidecars now support Script mode, just like in Task Steps (#1987)
• ✨ TaskRuns can now specify a different Scheduler Name in their podTemplate (#1790)
• ✨ JSONPath-like Star Array Notation can now be used in variable substitutions (#2085)
• ✨ The Tekton Controller can now be configured to monitor an individual namespace (#2144)
• ✨ Add description field to Spec (#2089)
• ✨ Add proxy parameters to Git PipelineResources (#2215)

Fixes

• 🐛 Fix redundant type conversion (#2142)
• 🐛 Fail step-script if param value is not applied (#1934)
• 🐛 Fix params-applied example (#1925)
• 🐛 Make pipelinerun as "cancelled" when taskrun is "cancelled" (#1935)
• 🐛 Fix release yaml for openshift install (#1959)
• 🐛 Remove Code Comment From v1alpha2 taskrun_types_test.go (#1967)
• 🐛 Correct message of Pipelinerun when timeout (#2024)
• 🐛 Enhance reconcile of taskrun to avoid extra pod creation (#2022)
• 🐛 Add random suffix when make volumn from secret (#2048)
• 🐛 Validate PipelineTask name as Task names (#2099)
• 🐛 Fixes Steps container spec serialization/deserialization (#2151)
• 🐛 Remove result initcontainer (#2175)
• 🐛 SetDefaults for embedded specs (Pipeline, Task) 🥄 (#2162)
• 🐛 Fix to FieldError fields name for duplicate param names and associated unit tests (#2195)
• 🐛 Fixes Task workspaces marshalling (#2200)
• 🐛 Handle the case of multiple versions of a status (#2194)
• 🐛 Panic in controller when step fails before image digest exporter (#2222)
• 🐛 Fix copying description also during upgrade (#2247)
• 🐛 Add checking for duplicate declared resources (#2266)
• 🐛 Fix re-applying v1beta1 TaskRun failing (#2285)
• 🐛 Fix the variable substitution for task results inside array parameters (#2300)
• 🐛 Add missing omitempty that breaks compatibility (#2301)
• 🐛 Correct missing field(s) error (#2295)

Misc

• 🔨 Update dind example to connect to daemon using TCP+TLS (#1932)
• 🔨 Add tekton.dev/release annotation to the webhook (#1942)
• 🔨 Use named field in test tables taco (#1954)
• 🔨 Add e2e test to cover TaskRun retries (#1975)
• 🔨 Increase timeout for e2e test_retry test (#1985)
• 🔨 Prepend tekton-bucket resource name with pipeline pill (#1982)
• 🔨 Remove messages about kodata in task logs (#2000)
• 🔨 Correct the number of expected pods created in e2e test case of "retry" (#1996)
• 🔨 Remove deprecated fields from PipelineResourceResult sweet_potato (#2011)
• 🔨 Make testcase of "retry" raise error rather than just log (#2033)
• 🔨 update cloudevents dependency and clean up deps (#2014)
• 🔨 Add symlink in kodata link (#2032)
• 🔨 Add a description field to pipeline workspace declarations (#2054)
• 🔨 Add jsonpath expand library (#1951)
• 🔨 Use vendor folder to speed up CI spoon (#2040)
• 🔨 Adding a version label to controller and webhook (#2064)
• 🔨 Refining status when Condition failed (#1696)
• 🔨 Add ContainerState and ContainerName for Sidecars (#2075)
• 🔨 Move Resources implementation to their package (#2103)
• 🔨 Update the kaniko executor image version to 0.17.1 (#2136)
• 🔨 Invalid Sink URI CloudEvent test sometimes includes quotes (#2166)
• 🔨 Add builder for resource description (#2224)
• 🔨 Creds-init writes to fixed location when HOME override is disabled (#2180)
• 🔨 Introduce v1beta1 e2e go tests (#2252)
• 🔨 Add the git resource ref to the ResourceResult for git resources. (#2238)
• 🔨 fix skipRootUserTests flag 🎏 (#2304)

Docs

• 📖 Adding Documentation on PipelineTask Timeout (#2130)
• 📖 Fix Install Guide formatting. (#2149)
• 📖 Rewrite the Tekton Pipelines overview for clarity and flow (#2030)
• 📖 Document default-managed-by-label (#1964)
• 📖 fix wrong default pod template example (#1997)
• 📖 Updating to include Tekton installtion (#2012)
• 📖 Linking to conditions-doc insteadof self (#2046)
• 📖 Indicate minimum cluster version is now 1.15 police_car (#2052)
• 📖 Add authority for resource deployments.apps to tutorial-role (#2034)
• 📖 Correct the wrong MD format for document: podTemplates (#2090)
• 📖 Fix Broken Link and Typo for LimitRange Docs (#2108)
• 📖 Installation: Added example for GoogleCloudStorage backend (#2123)
• 📖 Rewrite Install Guide for clarity and flow. (#2146)
• 📖 Fix Install Guide formatting. (#2149)
• 📖 Rewrite the Pipelines tutorial for clarity and flow. (#2068)
• 📖 Update some more example links and move task results example (#2148)
• 📖 Document Task Results maximum size (#2167)
• 📖 Update install instructions on OpenShift (#2169)
• 📖 Add params section to Pipelinerun doc (#2173)
• 📖 Fix pipeline spelling bug in developers/readme.md (#2184)
• 📖 Update docs to use v1beta1
• 📖 Remove MiniShift from install documentation (#2189)
• 📖 Fix broken markdown links in our doc (#2205)
• 📖 Spelling fixes in our doc (#2206)
• 📖 Add a Workspaces doc (#2230)
• 📖 Improve the clarity and flow in Workspaces documentation. (#2256)
• 📖 Fix unavailable link in document (#2271)
• 📖 Adds "commented" website front matter to docs (#2283)

Thanks

Thanks to all those who have contributed to the Beta!

• ❤️ @achedeuzot
• ❤️ @assertion
• ❤️ @bobcatfish
• ❤️ @cccfeng
• ❤️ @chanseokoh
• ❤️ @chmouel
• ❤️ @danielhelfand
• ❤️ @dewan-ahmed
• ❤️ @dibyom
• ❤️ @dlorenc
• ❤️ @eddycharly
• ❤️ @fraenkel
• ❤️ @gorkem
• ❤️ @GregDritschler
• ❤️ @guitcastro
• ❤️ @hrishin
• ❤️ @imjasonh
• ❤️ @itoutki
• ❤️ @jlpettersson
• ❤️ @mattmoor
• ❤️ @nikhil-thomas
• ❤️ @nilsotto
• ❤️ @othomann
• ❤️ @piyush-garg
• ❤️ @pritidesai
• ❤️ @sbwsg
• ❤️ @sergetron
• ❤️ @skaegi
• ❤️ @spomorski
• ❤️ @takirala
• ❤️ @tariq1890
• ❤️ @tomgeorge
• ❤️ @vdemeester
• ❤️ @vincent-pli
• ❤️ @waveywaves
• ❤️ @withlin
• ❤️ @wlynch

Tekton Pipeline release v0.11.0-rc4 "Ragdoll Norby"

🎉 Beta Release Candidate 4 🎉

This is the fourth release towards Beta and includes a few final bug fixes for issues discovered after RC3 went out. This will be the final release before we formally declare Beta ready.

🚨 If you are upgrading from an older version of Tekton you may need to delete your existing tekton-pipeline deployments before applying the 0.11 release candidates.

🚨 Submitting v1alpha1 Tasks more than once can now result in errors. Submitting a v1alpha1 Task once will work but submitting the same Task again will fail. To work around this problem use kubectl replace instead of apply or first delete the Task and then re-apply it.

This is a side-effect of the way Tekton internally upgrades Tasks from v1alpha1 to v1beta1. This issue will affect any Task that includes inputs.params or inputs.resources. On submission Kubernetes will return an error such as error when applying patch [...] validation failed: expected exactly one, got both: inputs.params, params.

🚨 Please also note that the minimum version of Kubernetes required to run Tekton is now 1.15.

• Docs @ v0.11.0-rc4
• Examples @ v0.11.0-rc4

Changes

Deprecation Notices (Same as RC1)

• 🚨 PipelineResources are not moving to Beta with Tekton's other types

  PipelineResources have been a source of some contention within the Tekton community over the past several months. While the abstraction they expose does provide some value they can often be difficult to understand, hard to debug when they go wrong, and are far too limited in number and scope. For these reasons and more we do not plan to promote PipelineResources into Beta and will instead provide a documented migration path for users that does not use the type at all. Towards this goal we have already introduced a git-clone Task to the Tekton Catalog that provides exactly the same behaviour as the Git PipelineResource and we plan to introduce similar Tasks for all of the other existing PipelineResource types as well.

  See the git-clone Task in the catalog.

• 🚨 The $HOME env var and workingDir of Steps will change in the next release

  Tekton currently overwrites the HOME environment variable in a Step's container to always be /tekton/home and the workingDir field of the Step's image to always be /workspace. This behaviour is problematic when a container depends on those values to be something specific for it to run correctly.

  In this release we are leaving Tekton's default behaviour alone but have introduced a new ConfigMap, named feature-flags, that allows you to disable it. In the next release we plan to flip this behaviour so that it is opt-in rather than opt-out. At some point in the future we plan to remove support for this overwriting behaviour entirely. (#2044).

Backwards incompatible changes (Same as RC1)

In current release:

• 🚨 The minimum required version of Kubernetes is now 1.15

  Bump kubernetes to 1.16.5 and knative/pkg to release-0.12 (#1894)

• 🚨 Submitting v1alpha1 Tasks more than once can now result in errors. Submitting a v1alpha1 Task once will work but submitting the same Task again will fail.

Fixes

• 🐛 Fix the variable substitution for task results inside array parameters (#2300)
• 🐛 Add missing omitempty that breaks compatibility (#2301)
• 🐛 Correct missing field(s) error (#2295)

Misc

• 🔨 fix skipRootUserTests flag 🎏 (#2304)

Thanks

Thanks to these contributors who contributed to v0.11.0-rc4!

• ❤️ @othomann
• ❤️ @jlpettersson
• ❤️ @GregDritschler
• ❤️ @vdemeester

Tekton Pipeline release v0.11.0-rc3 "Ragdoll Norby"

🎉 Beta Release Candidate 3 🎉

This is the third release towards Beta and includes bug fixes for issues discovered after RC2 went out. This is planned to be the final release before we formally declare Beta ready.

🚨 If you are upgrading from an older version of Tekton you may need to delete your existing tekton-pipeline deployments before applying the 0.11 release candidates.

🚨 Submitting v1alpha1 Tasks more than once can now result in errors. Submitting a v1alpha1 Task once will work but submitting the same Task again will fail. To work around this problem use kubectl replace instead of apply or first delete the Task and then re-apply it.

This is a side-effect of the way Tekton internally upgrades Tasks from v1alpha1 to v1beta1. This issue will affect any Task that includes inputs.params or inputs.resources. On submission Kubernetes will return an error such as error when applying patch [...] validation failed: expected exactly one, got both: inputs.params, params.

🚨 Please also note that the minimum version of Kubernetes required to run Tekton is now 1.15.

-Docs @ v0.11.0-rc3
-Examples @ v0.11.0-rc3

Changes

Deprecation Notices (Same as RC1)

• 🚨 PipelineResources are not moving to Beta with Tekton's other types

  PipelineResources have been a source of some contention within the Tekton community over the past several months. While the abstraction they expose does provide some value they can often be difficult to understand, hard to debug when they go wrong, and are far too limited in number and scope. For these reasons and more we do not plan to promote PipelineResources into Beta and will instead provide a documented migration path for users that does not use the type at all. Towards this goal we have already introduced a git-clone Task to the Tekton Catalog that provides exactly the same behaviour as the Git PipelineResource and we plan to introduce similar Tasks for all of the other existing PipelineResource types as well.

  See the git-clone Task in the catalog.

• 🚨 The $HOME env var and workingDir of Steps will change in the next release

  Tekton currently overwrites the HOME environment variable in a Step's container to always be /tekton/home and the workingDir field of the Step's image to always be /workspace. This behaviour is problematic when a container depends on those values to be something specific for it to run correctly.

  In this release we are leaving Tekton's default behaviour alone but have introduced a new ConfigMap, named feature-flags, that allows you to disable it. In the next release we plan to flip this behaviour so that it is opt-in rather than opt-out. At some point in the future we plan to remove support for this overwriting behaviour entirely. (#2044).

Backwards incompatible changes (Same as RC1)

In current release:

• 🚨 The minimum required version of Kubernetes is now 1.15

  Bump kubernetes to 1.16.5 and knative/pkg to release-0.12 (#1894)

• 🚨 Submitting v1alpha1 Tasks more than once can now result in errors. Submitting a v1alpha1 Task once will work but submitting the same Task again will fail.

Features

• ✨ Add proxy parameters to Git PipelineResources (#2215)

Fixes

• 🐛 Panic in controller when step fails before image digest exporter (#2222)
• 🐛 Fix copying description also during upgrade (#2247)
• 🐛 Add checking for duplicate declared resources (#2266)
• 🐛 Fix re-applying v1beta1 TaskRun failing (#2285)

Misc

• 🔨 Add builder for resource description (#2224)
• 🔨 Creds-init writes to fixed location when HOME override is disabled (#2180)
• 🔨 Introduce v1beta1 e2e go tests (#2252)
• 🔨 Add the git resource ref to the ResourceResult for git resources. (#2238)

Docs

• 📖 Add a Workspaces doc (#2230)
• 📖 Improve the clarity and flow in Workspaces documentation. (#2256)
• 📖 Fix unavailable link in document (#2271)
• 📖 Adds "commented" website front matter to docs (#2283)

Thanks

Thanks to these contributors who contributed to v0.11.0-rc3!

• ❤️ @vdemeester
• ❤️ @vincent-pli
• ❤️ @pritidesai
• ❤️ @piyush-garg
• ❤️ @skaegi
• ❤️ @GregDritschler
• ❤️ @sergetron
• ❤️ @dlorenc
• ❤️ @sbwsg

Tekton Pipeline release v0.10.2 "Bombay Robbie"

-Docs @ v0.10.2
-Examples @ v0.10.2

Fixes

• 🐛 Fix panic in controller related to image digest exporter (#2222)]

Tekton Pipeline release v0.11.0-rc2 "Ragdoll Norby"

🎉 Beta Release Candidate 2 🎉

This is the second release towards Beta and includes bug fixes for issues discovered after RC1 went out. There will be at least one more release candidate before the actual Beta.

🚨 If you are upgrading from an older version of Tekton you may need to delete your existing tekton-pipeline deployments before applying the 0.11 release candidates.

🚨 Submitting v1alpha1 Tasks more than once can now result in errors. Submitting a v1alpha1 Task once will work but submitting the same Task again will fail. To work around this problem use kubectl replace instead of apply or first delete the Task and then re-apply it.

This is a side-effect of the way Tekton internally upgrades Tasks from v1alpha1 to v1beta1. This issue will affect any Task that includes inputs.params or inputs.resources. On submission Kubernetes will return an error such as error when applying patch [...] validation failed: expected exactly one, got both: inputs.params, params.

🚨 Please also note that the minimum version of Kubernetes required to run Tekton is now 1.15.

-Docs @ v0.11.0-rc2
-Examples @ v0.11.0-rc2

Changes

Features

• ✨ Add description field to Spec (#2089)

Deprecation Notices (Same as RC1)

• 🚨 PipelineResources are not moving to Beta with Tekton's other types

  PipelineResources have been a source of some contention within the Tekton community over the past several months. While the abstraction they expose does provide some value they can often be difficult to understand, hard to debug when they go wrong, and are far too limited in number and scope. For these reasons and more we do not plan to promote PipelineResources into Beta and will instead provide a documented migration path for users that does not use the type at all. Towards this goal we have already introduced a git-clone Task to the Tekton Catalog that provides exactly the same behaviour as the Git PipelineResource and we plan to introduce similar Tasks for all of the other existing PipelineResource types as well.

  See the git-clone Task in the catalog.

• 🚨 The $HOME env var and workingDir of Steps will change in the next release

  Tekton currently overwrites the HOME environment variable in a Step's container to always be /tekton/home and the workingDir field of the Step's image to always be /workspace. This behaviour is problematic when a container depends on those values to be something specific for it to run correctly.

  In this release we are leaving Tekton's default behaviour alone but have introduced a new ConfigMap, named feature-flags, that allows you to disable it. In the next release we plan to flip this behaviour so that it is opt-in rather than opt-out. At some point in the future we plan to remove support for this overwriting behaviour entirely. (#2044).

Backwards incompatible changes (Same as RC1)

In current release:

• 🚨 The minimum required version of Kubernetes is now 1.15

  Bump kubernetes to 1.16.5 and knative/pkg to release-0.12 (#1894)

• 🚨 Submitting v1alpha1 Tasks more than once can now result in errors. Submitting a v1alpha1 Task once will work but submitting the same Task again will fail.

Fixes

• 🐛 Remove result initcontainer (#2175)
• 🐛 SetDefaults for embedded specs (Pipeline, Task) 🥄 (#2162)
• 🐛 Fix to FieldError fields name for duplicate param names and associated unit tests (#2195)
• 🐛 Fixes Task workspaces marshalling (#2200)
• 🐛 Handle the case of multiple versions of a status (#2194)

Misc

• 🔨 Invalid Sink URI CloudEvent test sometimes includes quotes (#2166)

Docs

• 📖 Rewrite the Pipelines tutorial for clarity and flow. (#2068)
• 📖 Update some more example links and move task results example (#2148)
• 📖 Document Task Results maximum size (#2167)
• 📖 Update install instructions on OpenShift (#2169)
• 📖 Add params section to Pipelinerun doc (#2173)
• 📖 Fix pipeline spelling bug in developers/readme.md (#2184)
• 📖 Update docs to use v1beta1
• 📖 Remove MiniShift from install documentation (#2189)
• 📖 Fix broken markdown links in our doc (#2205)
• 📖 Spelling fixes in our doc (#2206)

Thanks

Thanks to these contributors who contributed to v0.11.0-rc2!

• ❤️ @cccfeng
• ❤️ @chanseokoh
• ❤️ @nikhil-thomas
• ❤️ @piyush-garg
• ❤️ @sbwsg
• ❤️ @skaegi
• ❤️ @spomorski
• ❤️ @vdemeester

Tekton Pipeline release v0.11.0-rc1 "Ragdoll Norby"

🎉 Beta Release Candidate 1 🎉

• Docs @ v0.11.0-rc1
• Examples @ v0.11.0-rc1

With this release Tekton Pipelines introduces a new apiVersion, v1beta1. While the v1alpha1 version is continuing to be supported at this time we'd like to encourage anyone integrating with Pipelines to be aware of the upcoming API change and begin thinking about migrating over to the beta API. Documentation on migrating will be forthcoming, this release simply introduces the new version and allows us to publicise it.

Over the coming weeks we'll be working with the other Tekton projects to migrate their integrations to v1beta1 and fixing problems as they arise in subsequent Release Candidates.

🚨 If you are upgrading from an older version of Tekton you may need to delete your existing tekton-pipeline deployments before applying the 0.11 release candidates.

🚨 Submitting v1alpha1 Tasks more than once can now result in errors. Submitting a v1alpha1 Task once will work but submitting the same Task again will fail. To work around this problem first delete the Task and then reapply it.

This is a side-effect of the way Tekton internally upgrades Tasks from v1alpha1 to v1beta1. This issue will affect any Task that includes inputs.params or inputs.resources. On submission Kubernetes will return an error such as error when applying patch [...] validation failed: expected exactly one, got both: inputs.params, params.

🚨 Please also note that the minimum version of Kubernetes required to run Tekton is now 1.15.

Changes

Features

• ✨ Introduce the v1beta1 API Version

  Tekton Pipelines has introduced a new API version, v1beta1, with improvements to some of its APIs and Types.

  Add ClusterTask to v1alpha2 (#1946)
  Port TaskResults and TaskRunResults to v1alpha2 (#1948)
  Port Workspace in pipeline support to v1alpha2 (#1949)
  Add PipelineRun types to v1alpha2 (#1955)
  Add LimitRangeName to v1alpha2.PipelineRun tulip (#2009)
  Task, ClusterTask and Pipeline auto-conversion from v1alpha1 to v1alpha2 (#2002)
  TaskRun, and PipelineRun auto-conversion from v1alpha1 to v1alpha2 (#2025)
  Expose v1beta1 to the world (#2035)

• ✨ Improved LimitRange support

  Tekton Pipelines now plays more nicely with LimitRanges in a namespace when creating new Pods for TaskRuns.

  Leave Max Container Request Values at Original Indices (#1937)
  Check for LimitRange Minimum for TaskRun Container Requests (#1991)
  Add LimitRange Examples for PipelineRun and TaskRun (#2004)
  Pods created by TaskRuns will now respect any LimitRange minimums that exist in the namespace that the Pod runs in (#2020).

• ✨ Pipeline Resources can now be marked as optional

  PipelineResources can now be declared as optional, allowing Tasks to be more flexible in their handling of input resources.

  Enabling Pipeline Resources to be marked as Optional (#1910)

• ✨ Data can now be shared between Tasks using Task Results and Task Params

  A Pipeline can now feed Task Results into other Tasks through their Params. It is now much easier to pass small pieces of data through a Pipeline.

  Update task run status with results (#1921)
  Adding substitution for result path variable (#2018)
  Adding pipeline results (#2042)
  Make results folder writable (Fix for #2131) (#2143)

• ✨ Tekton Pipelines can be configured to no longer overwrite the HOME environment variable and workingDir of Steps

  In the next release of Tekton this behaviour will become the default!

  Allow disabling implicit HOME overwrite (#2044)
  Add handling of working directory (#2115)

• ✨ Sidecars now support Script mode, just like in Task Steps

  Add Script Support to Sidecars (#1987)

• ✨ TaskRuns can now specify a different Scheduler Name in their podTemplate

  Add SchedulerName to TaskRunSpec (#1790)

• ✨ JSONPath-like Star Array Notation can now be used in variable substitutions

  Adds Basic Support for Star Array Notation (#2085)

• ✨ The Tekton Controller can now be configured to monitor an individual namespace

  Allow controller to watch a specified namespace (#2144)

Deprecation Notices

• 🚨 PipelineResources are not moving to Beta with Tekton's other types

  PipelineResources have been a source of some contention within the Tekton community over the past several months. While the abstraction they expose does provide some value they can often be difficult to understand, hard to debug when they go wrong, and are far too limited in number and scope. For these reasons and more we do not plan to promote PipelineResources into Beta and will instead provide a documented migration path for users that does not use the type at all. Towards this goal we have already introduced a git-clone Task to the Tekton Catalog that provides exactly the same behaviour as the Git PipelineResource and we plan to introduce similar Tasks for all of the other existing PipelineResource types as well.

  See the git-clone Task in the catalog.

• 🚨 The $HOME env var and workingDir of Steps will change in the next release

  Tekton currently overwrites the HOME environment variable in a Step's container to always be /tekton/home and the workingDir field of the Step's image to always be /workspace. This behaviour is problematic when a container depends on those values to be something specific for it to run correctly.

  In this release we are leaving Tekton's default behaviour alone but have introduced a new ConfigMap, named feature-flags, that allows you to disable it. In the next release we plan to flip this behaviour so that it is opt-in rather than opt-out. At some point in the future we plan to remove support for this overwriting behaviour entirely. (#2044).

Backwards incompatible changes

In current release:

• 🚨 The minimum required version of Kubernetes is now 1.15

  Bump kubernetes to 1.16.5 and knative/pkg to release-0.12 (#1894)

• 🚨 Submitting v1alpha1 Tasks more than once can now result in errors. Submitting a v1alpha1 Task once will work but submitting the same Task again will fail. To work around this problem first delete the Task and then reapply it.

Fixes

• 🐛 Fix redundant type conversion (#2142)
• 🐛 Fail step-script if param value is not applied (#1934)
• 🐛 Fix params-applied example (#1925)
• 🐛 Make pipelinerun as "cancelled" when taskrun is "cancelled" (#1935)
• 🐛 Fix release yaml for openshift install (#1959)
• 🐛 Remove Code Comment From v1alpha2 taskrun_types_test.go (#1967)
• 🐛 Correct message of Pipelinerun when timeout (#2024)
• 🐛 Enhance reconcile of taskrun to avoid extra pod creation (#2022)
• 🐛 Add random suffix when make volumn from secret (#2048)
• 🐛 Validate PipelineTask name as Task names (#2099)
• 🐛 Fixes Steps container spec serialization/deserialization (#2151)

Misc

• 🔨 Update dind example to connect to daemon using TCP+TLS (#1932)
• 🔨 Add tekton.dev/release annotation to the webhook (#1942)
• 🔨 Use named field in test tables taco (#1954)
• 🔨 Add e2e test to cover TaskRun retries (#1975)
• 🔨 Increase timeout for e2e test_retry test (#1985)
• 🔨 Prepend tekton-bucket resource name with pipeline pill (#1982)
• 🔨 Remove messages about kodata in task logs (#2000)
• 🔨 Correct the number of expected pods created in e2e test case of "retry" (#1996)
• 🔨 Remove deprecated fields from PipelineResourceResult sweet_potato (#2011)
• 🔨 Make testcase of "retry" raise error rather than just log (#2033)
• 🔨 update cloudevents dependency and clean up deps (#2014)
• 🔨 Add symlink in kodata link (#2032)
• 🔨 Add a description field to pipeline workspace declarations (#2054)
• 🔨 Add jsonpath expand library (#1951)
• 🔨 Use vendor folder to speed up CI spoon (#2040)
• 🔨 Adding a version label to controller and webhook (#2064)
• 🔨 Refining status when Condition failed (#1696)
• 🔨 Add ContainerState and ContainerName for Sidecars (#2075)
• 🔨 Move Resources implementation to their package (#2103)
• 🔨 Update the kaniko executor image version to 0.17.1 (#2136)

Docs

• 📖 Adding Documentation on PipelineTask Timeout (#2130)
• 📖 Fix Install Guide formatting. (#2149)
• 📖 Rewrite the Tekton Pipelines overview for clarity and flow (#2030)
• 📖 Document default-managed-by-label (#1964)
• 📖 fix wrong default pod template example (#1997)
• 📖 Updating to include Tekton installtion (#2012)
• 📖 Linking to conditions-doc insteadof self (#2046)
• 📖 Indicate minimum cluster version is now 1.15 police_car (#2052)
• 📖 Add authority for resource deployments.apps to tutorial-role (#2034)
• 📖 Correct the wrong MD format for document: podTemplates (#2090)
• 📖 Fix Broken Link and Typo for LimitRange Docs (#2108)
• 📖 Installation: Added example for GoogleCloudStorage backend (#2123)
• 📖 Rewrite Install Guide for clarity and flow. (#2146)
• 📖 Fix Install Guide formatting. (#2149)

Thanks

Thanks to these contributors who contributed to v0.11.0-rc1!

• ❤️ @imjasonh
• ❤️ @achedeuzot
• ❤️ @assertion
• ❤️ @bobcatfish
• ❤️ @chmouel
• ❤️ @danielhelfand
• ❤️ @dewan-ahmed
• ❤️ @dibyom
• ❤️ @eddycharly
• ❤️ @fraenkel
• ❤️ @gorkem
• ❤️ @guitcastro
• ❤️ @HR...

Tekton Pipeline release v0.10.1 "Bombay Robbie"

-Docs @ v0.10.1
-Examples @ v0.10.1

Fixes

• 🐛 Ensure taskRef is non nil before setting defaults as this is an optio… #1966 (#1970)
• 🐛 Avoid a panic when sorting container statuses #1927 (#1943)
• 🐛 Add tekton.dev/release annotation to the webhook 🏋 #1942 (#1945)
• 🐛 leave max container request values at original index #1937 (#1962)
• 🐛 Fix release yaml for openshift install 🐸 #1959 (#1963)
• 🐛 Revert "Don't rely on .status.podName to find Pod associated with a T… #1971 (#1973)

Thanks

Thanks to these contributors who contributed to v0.10.1!

• ❤️ @imjasonh
• ❤️ @vdemeester
• ❤️ @takirala
• ❤️ @danielhelfand