RHDEVDOCS 5984 disabling inline spec

install_config/customizing-configurations-in-the-tektonconfig-cr.adoc

@@ -43,6 +43,8 @@ include::modules/op-disabling-the-integretion-of-tekton-hub.adoc[leveloffset=+1]
 
 include::modules/op-disabling-automatic-creation-of-rbac-resources.adoc[leveloffset=+1]
 
+include::modules/op-disabling-inline-spec.adoc[leveloffset=+1]
+
 include::modules/op-automatic-pruning-taskrun-pipelinerun.adoc[leveloffset=+1]
 
 include::modules/op-default-pruner-configuration.adoc[leveloffset=+2]

modules/op-disabling-inline-spec.adoc

@@ -0,0 +1,85 @@
+// This module is included in the following assemblies:
+// * install_config/customizing-configurations-in-the-tektonconfig-cr.adoc
+
+:_mod-docs-content-type: CONCEPT
+[id="op-disabling-inline-spec_{context}"]
+= Disabling inline specification of pipelines and tasks
+
+By default, {pipelines-shortname} supports inline specification of pipelines and tasks in the following cases:
+
+* You can create a `Pipeline` CR that includes one or more task specifications, as in the following example:
++
+.Example of an inline specification in a `Pipeline` CR
+[source,yaml]
+----
+apiVersion: operator.tekton.dev/v1
+kind: Pipeline
+metadata:
+  name: pipelineInline
+spec:
+  tasks:
+    taskSpec:
+# ...
+----
+
+* You can create a `PipelineRun` custom resource (CR) that includes a pipeline specification, as in the following example:
++
+.Example of an inline specification in a `PipelineRun` CR
+[source,yaml]
+----
+apiVersion: operator.tekton.dev/v1
+kind: PipelineRun
+metadata:
+  name: pipelineRunInline
+spec:
+  pipelineSpec:
+    tasks:
+# ...
+----
+
+* You can create a `TaskRun` custom resource (CR) that includes a task specification, as in the following example:
++
+.Example of an inline specification in a `TaskRun` CR
+[source,yaml]
+----
+apiVersion: operator.tekton.dev/v1
+kind: TaskRun
+metadata:
+  name: taskRunInline
+spec:
+  taskSpec:
+    steps:
+# ...
+----
+
+You can disable inline specification in some or all of these cases. To disable the inline specification, set the `disable-inline-spec` field of the `.spec.pipeline` specification of the `TektonConfig` CR, as in the following example:
+
+.Example configuration that disables inline specification
+[source,yaml]
+----
+apiVersion: operator.tekton.dev/v1alpha1
+kind: TektonConfig
+metadata:
+  name: config
+spec:
+  pipeline:
+    disable-inline-spec: "pipeline,pipelinerun,taskrun"
+# ...
+----
+
+You can set the `disable-inline-spec` parameter to any single value or to a comma-separated list of multiple values. The following values for the parameter are valid:
+
+.Supported values for the `disable-inline-spec` parameter
+|===
+| Value | Description
+
+|`pipeline`
+|You cannot use a `taskSpec:` spec to define a task inside a `Pipeline` CR. Instead, you must use a `taskRef:` spec to incorporate a task from a `Task` CR or to specify a task using a resolver.
+
+|`pipelinerun`
+|You cannot use a `pipelineSpec:` spec to define a pipeline inside a `PipelineRun` CR. Instead, you must use a `pipelineRef:` spec to incorporate a pipeline from a `Pipeline` CR or to specify a pipeline using a resolver.
+
+|`taskrun`
+|You cannot use a `taskSpec:` spec to define a task inside a `TaskRun` CR. Instead, you must use a `taskRef:` spec to incorporate a task from a `Task` CR or to specify a task using a resolver.
+
+|===