Tekton Pipeline release v0.25.0 "Black-Footed Throb"

[jerop]

🎉 Hermetic Execution, Embedded Custom Tasks and Graceful Termination & Timeouts 🎉

-Docs @ v0.25.0
-Examples @ v0.25.0

Installation one-liner

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

Upgrade Notices

N/A

Features

• ✨ Add ConfigMap which can contain pipelines info and RBAC to access this ConfigMap (Add ConfigMap which can contain pipelines info and RBAC to access this ConfigMap #3971)

• ✨ Add support for experimental hermetic execution mode to TaskRuns (Add support for experimental hermetic execution mode to TaskRuns #3956)

  Add support for experimental hermetic execution mode to TaskRuns

• ✨ Graceful Pipeline Run Termination (Graceful Pipeline Run Termination #3915)

  The new PipelineRun spec statuses have been added to control the way who a PipelineRun is being canceled or stopped.

  • "StoppedRunFinally" - To stop (i.e. let the tasks complete, then execute finally tasks) a PipelineRun
  • "CancelledRunFinally" - To cancel (i.e. interrupt any executing non finally tasks, then execute finally tasks)
  • "Cancelled" - replaces today's "PipelineRunCancelled" - i.e. interrupt any executing tasks without running finally tasks

  Support for existing statuses has been left unchanged. The status "PipelineRunCancelled" is deprecated and replaced by "Cancelled" (it would be removed in v1). The new states are released as alpha API features. Read more in TEP#0058.

• ✨ TEP-0061, Allow custom task to be embedded. (TEP-0061, Allow custom task to be embedded. #3901)

  It is now possible to embed the spec of a custom task in a Run resource, whether stand-alone or embedded in a Pipeline.

  • API changes, This PR adds new APIs i.e. adds a field Spec *EmbeddedRunSpec to RunSpec
  • An embedded task will accepts new field Spec with type runtime.RawExtension in addition to
    ApiVersion and Kind fields of type string (as part of runtime.TypeMeta)
  • Validation changes, in addition to adding support for Run.RunSpec.Spec the validations will be changed
    to support "One of Run.RunSpec.Spec or Run.RunSpec.Ref " only and not both as part of a single
    API request to kubernetes.

  action required: Developers of custom controllers (existing and new), who would like to support
  embedded spec for their custom task, need to implement the logic required to extract, validate
  and use the custom task spec from the new RunSpec.Spec field. Please review the documentation
  on upgrading, for more details and some examples.

• ✨ Add a Timeouts optional field to pipelinerun (Add a Timeouts optional field to pipelinerun #3843)

  • API changes
    • Added field Timeouts to PipelineRun spec. It is a dict with the following sub-fields
      • pipeline, to control the pipeline failure timeout
      • tasks, to control the pipeline tasks failure timeout
      • finally, to control the pipeline finally tasks failure timeout
  • Changes in behavior
    • When supplied, a timeouts field combination permits deciding which part of the pipeline runtime is allocated to tasks and finally tasks.

• ✨ Add variables context.pipelineTask.retries and context.task.retry-count (Add variables context.pipelineTask.retries and context.task.retry-count #3770)

Deprecation Notices

• 🚨 "PipelineRunCancelled" is deprecated

  The status "PipelineRunCancelled" is deprecated and replaced by "Cancelled" (it would be removed in v1) (Graceful Pipeline Run Termination #3915)

Backwards incompatible changes

N/A

Fixes

• 🐛 Fix Windows image entrypoint paths for parity with Linux (Fix Windows image entrypoint paths for parity with Linux #4018)

• 🐛 A custom task check could be true, even though the Provided Spec is invalid. (A custom task check could be true, even though the Provided Spec is invalid. #4005)

• 🐛 Fix Workspaces in Sidecar to be serialized as workspaces not Workspaces (Fix Workspaces in Sidecar to be serialized as workspaces not Workspaces #3966)

• 🐛 Encode scripts as base 64 to avoid k8s mangling 40 (Encode scripts as base 64 to avoid k8s mangling "$$" #3963)

  Scripts in Tasks are now written into the Task's pod using base64 to avoid kubernetes' built-in arg processing. This means they're a little larger than they were prior to this release but otherwise should continue working as expected.

• 🐛 Only fetch the definitions once 🧙 (Only fetch the definitions once 🧙 #3941)

  Only fetch the definition once, and then used the spec stored in the status as source of truth.
  This reduce the probable race condition when a PipelineRun or a TaskRun refers to a Pipeline or Task that changes during its execution.

• 🐛 Skip heavy validation on deletion 🙃 (Skip *heavy* validation on deletion 🙃 #3937)

  Skip heavy validation on deletion in the webhook

• 🐛 Validate run for both ref and spec as nil. (Validate run for both ref and spec as nil. #3977)

Misc

• 🔨 Revert Fix issue with 69 in Script blocks (Revert "Fix issue with "$$" in Script blocks" #3938)

  Revert fix for instances of "$$" in script blocks. Kubernetes replaces "$$" with a single "$" and your scripts need to deal appropriately with these instances.

• 🔨 Cleanup integraton tests for multi-arch case (Cleanup integraton tests for multi-arch case #3998)

• 🔨 Fix list of proposed kind labels for PRs (Fix list of proposed kind labels for PRs #3987)

• 🔨 Use tektoncd/results repo for git-init symbolic ref tests (Use tektoncd/results repo for git-init symbolic ref tests #4038)

• 🔨 Add Dockerfiles for Windows entrypoint and nop images (Add Dockerfiles for Windows entrypoint and nop images #3996)

• 🔨 Add hermetic test running as non-root user (Add hermetic test running as non-root user #3973)

• 🔨 Change the way we run e2e tests with feature gates in pipelines (Change the way we run e2e tests with feature gates in pipelines #3930)

Docs

• 📖 Update api-spec.md to fix some formatting (Update api-spec.md to fix some formatting #4030)

• 📖 Add v0.24.2 to the README (Add v0.24.2 to the README #4015)

• 📖 Fix minor typo in auth docs (Fix minor typo in auth docs #3992)

• 📖 Document how to use the kind tool and the Tekton/plumbing convenience script (Document how to use the kind tool and the Tekton/plumbing convenience script #3972)

  Documenting how to use the kind tool to setup the development environment.

• 📖 Organize DEVELOPMENT.md, provide consistent examples & reflect go mod support (Organize DEVELOPMENT.md, provide consistent examples & reflect go mod support #3955)

  Organized DEVELOPMENT.md to provide more consistent examples and instructions.

• 📖 Link to docs and examples for v0.24.3 (Link to docs and examples for v0.24.3 #4031)

• 📖 Update docs to use Kubernetes 1.18 as the minimum version (Update docs to use Kubernetes 1.18 as the minimum version #3986)

• 📖 docs(pipelines): specify how to reference an array parameter (docs(pipelines): specify how to reference an array parameter #3967)

• 📖 Document the safe-to-evict annotation on the webhook deployment (Document the safe-to-evict annotation on the webhook deployment #3961)

• 📖 Add missing frontmatter to some docs (Add missing frontmatter to some docs #3958)

• 📖 Update pipelines.md (Update pipelines.md #3946)

• 📖 Link to docs and examples for v0.24.1 (Link to docs and examples for v0.24.1 #3944)

• 📖 Format code blocks with prettier (Format code blocks with prettier #3911)

Thanks

Thanks to these contributors who contributed to v0.25.0!

• ❤️ @R2wenD2
• ❤️ @ScrapCodes
• ❤️ @afrittoli
• ❤️ @aiden-deloryn
• ❤️ @barthy1
• ❤️ @eliasnorrby
• ❤️ @imjasonh
• ❤️ @jeffmaury
• ❤️ @jerop
• ❤️ @jmlrt
• ❤️ @mrutkows
• ❤️ @n3wscott
• ❤️ @nikhil-thomas
• ❤️ @priyawadhwa
• ❤️ @rafalbigaj
• ❤️ @rguichard
• ❤️ @sbwsg
• ❤️ @souleb
• ❤️ @vdemeester
• ❤️ @vinamra28
• ❤️ @yaoxiaoqi

Extra shout-out for awesome release notes:

• 😍 @R2wenD2
• 😍 @ScrapCodes
• 😍 @aiden-deloryn
• 😍 @jeffmaury
• 😍 @jerop
• 😍 @mrutkows
• 😍 @nikhil-thomas
• 😍 @priyawadhwa
• 😍 @rafalbigaj
• 😍 @sbwsg
• 😍 @souleb
• 😍 @vdemeester
• 😍 @vinamra28
• 😍 @yaoxiaoqi

---

This discussion was created from the release Tekton Pipeline release v0.25.0 "Black-Footed Throb".