Skip to content

Commit 0868e1e

Browse files
shipsingshipsing
committed
RHDEVDOCS-5062: Documenting Pipelines 1.10 RN
1 parent 110a6c8 commit 0868e1e

File tree

3 files changed

+158
-0
lines changed

3 files changed

+158
-0
lines changed

‎cicd/pipelines/op-release-notes.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,8 @@ include::modules/op-tkn-pipelines-compatibility-support-matrix.adoc[leveloffset=
2323
include::modules/making-open-source-more-inclusive.adoc[leveloffset=+1]
2424

2525
// Modules included, most to least recent
26+
include::modules/op-release-notes-1-10.adoc[leveloffset=+1]
27+
2628
include::modules/op-release-notes-1-9.adoc[leveloffset=+1]
2729

2830
include::modules/op-release-notes-1-8.adoc[leveloffset=+1]

‎modules/op-release-notes-1-10.adoc

Lines changed: 155 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,155 @@
1+
// Module included in the following assembly:
2+
//
3+
// * cicd/pipelines/op-release-notes.adoc
4+
:_content-type: REFERENCE
5+
[id="op-release-notes-1-10_{context}"]
6+
= Release notes for {pipelines-title} General Availability 1.10
7+
8+
With this update, {pipelines-title} General Availability (GA) 1.10 is available on {product-title} 4.11 and later versions.
9+
10+
[id="new-features-1-10_{context}"]
11+
== New features
12+
13+
In addition to fixes and stability improvements, the following sections highlight what is new in {pipelines-title} 1.10.
14+
15+
[id="pipelines-new-features-1-10_{context}"]
16+
=== Pipelines
17+
18+
* With this update, you can specify environment variables in a `PipelineRun` or `TaskRun` pod template to override or append the variables that are configured in a task or step. Also, you can specify environment variables in a default pod template to use those variables globally for all `PipelineRuns` and `TaskRuns`. This update also adds a new default configuration named `forbidden-envs` to filter environment variables while propagating from pod templates.
19+
* With this update, custom tasks in pipelines are enabled by default.
20+
+
21+
[NOTE]
22+
====
23+
To disable this update, set the `enable-custom-tasks` flag to `false` in the `feature-flags` config custom resource.
24+
====
25+
26+
* This update supports the `v1beta1.CustomRun` API version for custom tasks.
27+
* This update adds support for the `PipelineRun` reconciler to create a custom run. For example, custom `TaskRuns` created from `PipelineRuns` can now use the `v1beta1.CustomRun` API version instead of `v1alpha1.Run`, if the `custom-task-version` feature flag is set to `v1beta1`, instead of the default value `v1alpha1`.
28+
+
29+
[NOTE]
30+
====
31+
You need to update the custom task controller to listen for the `*v1beta1.CustomRun` API version instead of `*v1alpha1.Run` in order to respond to `v1beta1.CustomRun` requests.
32+
====
33+
34+
* This update adds a new `retries` field to the `v1beta1.TaskRun` and `v1.TaskRun` specifications.
35+
36+
37+
[id="triggers-new-features-1-10_{context}"]
38+
=== Triggers
39+
40+
* With this update, triggers support the creation of `Pipelines`, `Tasks`, `PipelineRuns`, and `TaskRuns` objects of the `v1` API version along with `CustomRun` objects of the `v1beta1` API version.
41+
* With this update, GitHub Interceptor blocks a pull request trigger from being executed unless invoked by an owner or with a configurable comment by an owner.
42+
+
43+
[NOTE]
44+
====
45+
To enable or disable this update, set the value of the `githubOwners` parameter to `true` or `false` in the GitHub Interceptor configuration file.
46+
====
47+
48+
* With this update, GitHub Interceptor has the ability to add a comma delimited list of all files that have changed for the push and pull request events. The list of changed files is added to the `changed_files` property of the event payload in the top-level extensions field.
49+
* This update changes the `MinVersion` of TLS to `tls.VersionTLS12` so that triggers run on {product-title} when the Federal Information Processing Standards (FIPS) mode is enabled.
50+
51+
52+
[id="cli-new-features-1-10_{context}"]
53+
=== CLI
54+
55+
* This update adds support to pass a Container Storage Interface (CSI) file as a workspace at the time of starting a `Task`, `ClusterTask` or `Pipeline`.
56+
* This update adds `v1` API support to all CLI commands associated with task, pipeline, pipeline run, and task run resources. Tekton CLI works with both `v1beta1` and `v1` APIs for these resources.
57+
* This update adds support for an object type parameter in the `start` and `describe` commands.
58+
59+
60+
[id="operator-new-features-1-10_{context}"]
61+
=== Operator
62+
63+
* This update adds a `default-forbidden-env` parameter in optional pipeline properties. The parameter includes forbidden environment variables that should not be propagated if provided through pod templates.
64+
* This update adds support for custom logos in Tekton Hub UI. To add a custom logo, set the value of the `customLogo` parameter to base64 encoded URI of logo in the Tekton Hub CR.
65+
* This update increments the version number of the git-clone task to 0.9.
66+
67+
68+
[id="chains-new-features-1-10_{context}"]
69+
=== Tekton Chains
70+
71+
* This update adds annotations and labels to the `PipelineRun` and `TaskRun` attestations.
72+
* This update adds a new format named `slsa/v1`, which generates the same provenance as the one generated when requesting in the `in-toto` format.
73+
* With this update, Sigstore features are moved out from the experimental features.
74+
* With this update, the `predicate.materials` function includes image URI and digest information from all steps and sidecars for a `TaskRun` object.
75+
76+
77+
[id="tekton-hub-new-features-1-10_{context}"]
78+
=== {tekton-hub}
79+
80+
* This update supports installing, upgrading, or downgrading Tekton resources of the `v1` API version on the cluster.
81+
* This update supports adding a custom logo in place of the {tekton-hub} logo in UI.
82+
* This update extends the `tkn hub install` command functionality by adding a `--type artifact` flag, which fetches resources from the Artifact Hub and installs them on your cluster.
83+
* This update adds support tier, catalog, and org information as labels to the resources being installed from Artifact Hub to your cluster.
84+
85+
86+
[id="pac-new-features-1-10_{context}"]
87+
=== {pac}
88+
89+
* This update enhances incoming webhook support. For a GitHub application installed on the {product-title} cluster, you do not need to provide the `git_provider` specification for an incoming webhook. Instead, {pac} detects the secret and use it for the incoming webhook.
90+
* With this update, you can use the same token to fetch remote tasks from the same host on GitHub with a non-default branch.
91+
* With this update, {pac} supports Tekton `v1` templates. You can have `v1` and `v1beta1` templates, which {pac} reads for PR generation. The PR is created as `v1` on cluster.
92+
* Before this update, OpenShift console UI would use a hardcoded pipeline run template as a fallback template when a runtime template was not found in the OpenShift namespace. This update in the `pipelines-as-code` config map provides a new default pipeline run template named, `pipelines-as-code-template-default` for the console to use.
93+
* With this update, {pac} supports Tekton Pipelines 0.44.0 minimal status.
94+
* With this update, {pac} supports Tekton `v1` API, which means {pac} is now compatible with Tekton v0.44 and later.
95+
* With this update, you can configure custom console dashboards in addition to configuring a console for OpenShift and Tekton dashboards for k8s.
96+
* With this update, {pac} detects the installation of a GitHub application initiated using the `tkn pac create repo` command and does not require a GitHub webhook if it was installed globally.
97+
* Before this update, if there was an error on a `PipelineRun` execution and not on the tasks attached to `PipelineRun`, {pac} would not report the failure properly. With this update, {pac} reports the error properly on the GitHub checks when a `PipelineRun` could not be created.
98+
* With this update, {pac} includes a `target_namespace` variable, which expands to the currently running namespace where the `PipelineRun` is executed.
99+
* With this update, {pac} lets you bypass GitHub enterprise questions in the CLI bootstrap GitHub application.
100+
* With this update, {pac} does not report errors when the repository CR was not found.
101+
* With this update, {pac} reports an error if multiple pipeline runs with the same name were found.
102+
103+
104+
[id="breaking-changes-1-10_{context}"]
105+
== Breaking changes
106+
107+
* With this update, the prior version of the `tkn` command is not compatible with {pipelines-title} 1.10.
108+
* This update removes support for `Cluster` and `CloudEvent` pipeline resources from Tekton CLI. You cannot create pipeline resources by using the `tkn pipelineresource create` command. Also, pipeline resources are no longer supported in the `start` command of a task, cluster task, or pipeline.
109+
* This update removes `tekton` as a provenance format from Tekton Chains.
110+
111+
112+
[id="deprecated-features-1-10_{context}"]
113+
== Deprecated and removed features
114+
115+
* In {pipelines-title} 1.10, the `ClusterTask` commands are now deprecated and are planned to be removed in a future release. The `tkn task create` command is also deprecated with this update.
116+
* In {pipelines-title} 1.10, the flags `-i` and `-o` that were used with the `tkn task start` command are now deprecated because the `v1` API does not support pipeline resources.
117+
* In {pipelines-title} 1.10, the flag `-r` that was used with the `tkn pipeline start` command is deprecated because the `v1` API does not support pipeline resources.
118+
* The {pipelines-title} 1.10 update sets the `openshiftDefaultEmbeddedStatus` parameter to `both` with `full` and `minimal` embedded status. The flag to change the default embedded status is also deprecated and will be removed. In addition, the pipeline default embedded status will be changed to `minimal` in a future release.
119+
120+
[id="known-issues-1-10_{context}"]
121+
== Known issues
122+
123+
* This update includes the following backward incompatible changes:
124+
** Removal of the `PipelineResources` cluster
125+
** Removal of the `PipelineResources` cloud event
126+
* If the pipelines metrics feature does not work after a cluster upgrade, run the following command as a workaround:
127+
+
128+
[source,terminal]
129+
----
130+
$ oc get tektoninstallersets.operator.tekton.dev | awk '/pipeline-main-static/ {print $1}' | xargs oc delete tektoninstallersets
131+
----
132+
* With this update, usage of external databases, such as the Crunchy PostgreSQL is not supported on {ibmpowerProductName}, {ibmzProductName}, and {linuxoneProductName}. Instead, use the default {tekton-hub} database.
133+
134+
[id="fixed-issues-1-10_{context}"]
135+
== Fixed issues
136+
137+
* Before this update, the `opc pac` command generated a runtime error instead of showing any help. This update fixes the `opc pac` command to show the help message.
138+
* Before this update, running the `tkn pac create repo` command needed the webhook details for creating a repository. With this update, the `tkn-pac create repo` command does not configure a webhook when your GitHub application is installed.
139+
* Before this update, {pac} would not report a pipeline run creation error when Tekton Pipelines had issues creating the `PipelineRun` resource. For example, a non-existing task in a pipeline run would show no status. With this update, {pac} shows the proper error message coming from Tekton Pipelines along with the task that is missing.
140+
* This update fixes UI page redirection after a successful authentication. Now, you are redirected to the same page where you had attempted to log in to Tekton Hub.
141+
* This update fixes the `list` command with these flags, `--all-namespaces` and `--output=yaml`, for a cluster task, an individual task, and a pipeline.
142+
* This update removes the forward slash in the end of the `repo.spec.url` URL so that it matches the URL coming from GitHub.
143+
* Before this update, the `marshalJSON` function would not marshal a list of objects. With this update, the `marshalJSON` function marshals the list of objects.
144+
* With this update, {pac} lets you bypass GitHub enterprise questions in the CLI bootstrap GitHub application.
145+
* This update fixes the GitHub collaborator check when your repository has more than 100 users.
146+
* With this update, the `sign` and `verify` commands for a task or pipeline now work without a kubernetes configuration file.
147+
* With this update, Tekton Operator cleans leftover pruner cron jobs if pruner has been skipped on a namespace.
148+
* Before this update, the API `ConfigMap` object would not be updated with a user configured value for a catalog refresh interval. This update fixes the `CATALOG_REFRESH_INTERVAL` API in the Tekon Hub CR.
149+
* This update fixes reconciling of `PipelineRunStatus` when changing the `EmbeddedStatus` feature flag. This update resets the following parameters:
150+
** The `status.runs` and `status.taskruns` parameters to `nil` with `minimal EmbeddedStatus`
151+
** The `status.childReferences` parameter to `nil` with `full EmbeddedStatus`
152+
* This update adds a conversion configuration to the `ResolutionRequest` CRD. This update properly configures conversion from the `v1alpha1.ResolutionRequest` request to the `v1beta1.ResolutionRequest` request.
153+
* This update checks for duplicate workspaces associated with a pipeline task.
154+
* This update fixes the default value for enabling resolvers in the code.
155+
* This update fixes `TaskRef` and `PipelineRef` names conversion by using a resolver.

‎modules/op-tkn-pipelines-compatibility-support-matrix.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@ GA:: General Availability
1818
| {pipelines-title} Version 7+| Component Version | OpenShift Version | Support Status
1919

2020
| Operator | Pipelines | Triggers | CLI | Catalog | Chains | Hub | {pac} | |
21+
|1.10 | 0.44.x | 0.23.x | 0.30.x | NA | 0.15.x (TP) | 1.12.x (TP) | 0.17.x (GA) | 4.11, 4.12, 4.13 (planned) | GA
2122

2223
|1.9 | 0.41.x | 0.22.x | 0.28.x | NA | 0.13.x (TP) | 1.11.x (TP) | 0.15.x (GA) | 4.11, 4.12, 4.13 (planned) | GA
2324

0 commit comments

Comments
 (0)