[KOGITO-9974] cluster-wide supporting services

Signed-off-by: Tommy Hughes <[email protected]>

serverlessworkflow/modules/ROOT/pages/cloud/operator/supporting-services.adoc

@@ -2,19 +2,19 @@
 :compat-mode!:
 // Metadata:
 :description: Deploy Supporting Services with {operator_name}
-:keywords: kogito, sonataflow, workflow, serverless, operator, kubernetes, openshift, containers, data, index, job, service
+:keywords: kogito, sonataflow, workflow, serverless, operator, kubernetes, openshift, containers, data, index, job, service, cluster, wide, scoped, cluster-wide, cluster-scoped
 // links
 :kogito_serverless_operator_url: https://github.com/apache/incubator-kie-kogito-serverless-operator/
 
-By default, workflows use an embedded version of xref:data-index/data-index-core-concepts.adoc[Data Index]. This document describes how to deploy supporting services, like Data Index, on a cluster using the link:{kogito_serverless_operator_url}[{operator_name}].
+By default, workflows use an embedded version of xref:../../data-index/data-index-core-concepts.adoc[Data Index]. This document describes how to deploy supporting services, like Data Index, on a cluster using the link:{kogito_serverless_operator_url}[{operator_name}].
 
 [IMPORTANT]
 ====
-{operator_name} is under active development with features yet to be implemented. Please see xref:cloud/operator/known-issues.adoc[].
+{operator_name} is under active development with features yet to be implemented. Please see xref:known-issues.adoc[].
 ====
 
 .Prerequisites
-* The {operator_name} installed. See xref:cloud/operator/install-serverless-operator.adoc[] guide
+* The {operator_name} installed. See xref:install-serverless-operator.adoc[] guide
 * A postgresql database, if persistence is required
 
 [#deploy-supporting-services]
@@ -98,9 +98,32 @@ spec:
 <4> Number of Data Index pods, defaults to `1`
 <5> Custom Data Index container image name
 
+[#cluster-wide-services]
+== Cluster-Wide Supporting Services
+
+The `SonataFlowClusterPlatform` CR is optionally used to specify a cluster-wide set of supporting services for workflow consumption. This is done by referencing an existing, namespaced `SonataFlowPlatform` resource.
+
+Following is a basic configuration. It will allow workflows cluster-wide to leverage whatever supporting services are configured in the chosen "central" namespace.
+
+.Example of a basic SonataFlowClusterPlatform CR
+[source,yaml,subs="attributes+"]
+----
+apiVersion: sonataflow.org/v1alpha08
+kind: SonataFlowClusterPlatform
+metadata:
+  name: cluster-platform
+spec:
+  platformRef:
+    name: sonataflow-platform
+    namespace: <central namespace>
+----
+
+NOTE: These cluster-wide services can be overridden in any namespace, by configuring that namespace's `SonataFlowPlatform.spec.services`.
+
 == Additional resources
 
-* xref:data-index/data-index-service.adoc[]
-* xref:cloud/operator/known-issues.adoc[]
+* xref:../../data-index/data-index-service.adoc[data-index-service.adoc]
+* xref:enabling-jobs-service.adoc[]
+* xref:known-issues.adoc[]
 
 include::../../../pages/_common-content/report-issue.adoc[]