From d584f64b97cd1035cc862da63bc24aad50e44655 Mon Sep 17 00:00:00 2001 From: masauso-lungu Date: Wed, 6 Sep 2023 13:38:55 +0300 Subject: [PATCH] Domunented changing the installation target namespace for pipelines. Update to address SME's review. miner update to address SME's review. --- ...configurations-in-the-tektonconfig-cr.adoc | 3 ++ ...pelines-installation-target-namespace.adoc | 32 +++++++++++++++++++ 2 files changed, 35 insertions(+) create mode 100644 modules/op-changing-pipelines-installation-target-namespace.adoc diff --git a/cicd/pipelines/customizing-configurations-in-the-tektonconfig-cr.adoc b/cicd/pipelines/customizing-configurations-in-the-tektonconfig-cr.adoc index 0efba4b132e4..1cb1313991ef 100644 --- a/cicd/pipelines/customizing-configurations-in-the-tektonconfig-cr.adoc +++ b/cicd/pipelines/customizing-configurations-in-the-tektonconfig-cr.adoc @@ -8,6 +8,7 @@ toc::[] In {pipelines-title}, you can customize the following configurations by using the `TektonConfig` custom resource (CR): +* Changing the {pipelines-shortname} installation target namespace * Configuring the {pipelines-title} control plane * Changing the default service account * Disabling the service monitor @@ -22,6 +23,8 @@ In {pipelines-title}, you can customize the following configurations by using th * You have installed the {pipelines-title} Operator. +include::modules/op-changing-pipelines-installation-target-namespace.adoc[leveloffset=+1] + include::modules/op-configuring-pipelines-control-plane.adoc[leveloffset=+1] include::modules/op-modifiable-fields-with-default-values.adoc[leveloffset=+2] diff --git a/modules/op-changing-pipelines-installation-target-namespace.adoc b/modules/op-changing-pipelines-installation-target-namespace.adoc new file mode 100644 index 000000000000..c60267a047c9 --- /dev/null +++ b/modules/op-changing-pipelines-installation-target-namespace.adoc @@ -0,0 +1,32 @@ +// This module is included in the following assembly: +// +// *openshift_pipelines/customizing-configurations-in-the-tektonconfig-cr.adoc + +:_content-type: PROCEDURE +[id="op-changing-pipelines-installation-target-namespace_{context}"] += Changing the {pipelines-shortname} installation target namespace + +By default, the {pipelines-shortname} is installed in the `openshift-pipelines` namespace. +You can change the {pipelines-shortname} installation target namespace by editing the `targetNamespace` field in the specificaton of the `TektonConfig` custom resource (CR) to a custom namespace, for example ``. The {pipelines-shortname} installation is automatically moved to the new namespace specified. + +.Example +[source,yaml] +---- +apiVersion: operator.tekton.dev/v1alpha1 +kind: TektonConfig +spec: + targetNamespace: <1> +---- + +<1> Replace the variable your defined target namespace. + +[NOTE] +==== +Setting `openshift-operators` namespace as targetNamespace is not allowed. You will get an error if you set `openshift-operators` as targetNamespace. +==== + +[WARNING] +==== +when you change the target namespace, the previous namespace (`openshift-pipelines` by default) is reomved and all resources in it, including pipelines, tasks, secrets and so on, are lost. +==== +