kie-kogito-serverless-operator-459: Restructuring of the Cloud -> Operator -> Persistence chapter

serverlessworkflow/antora.yml

@@ -53,8 +53,8 @@ asciidoc:
     #
     #  Versions 
     #
-    quarkus_version: 3.2.9.Final
-    quarkus_platform_version: 3.2.9.Final
+    quarkus_version: 3.8.4
+    quarkus_platform_version: 3.8.4
     java_min_version: 17+
     maven_min_version: 3.9.3
     graalvm_min_version: 22.3.0
@@ -70,9 +70,20 @@ asciidoc:
     knative_version: 1.13
     knative_serving_version: 1.13
     knative_eventing_version: 1.13
+    kogito_version: 999-SNAPSHOT
     # only used in downstream
     operator_version: main
 
+    # Persistence extensions for the kogito-swf-builder
+    groupId_quarkus-agroal: io.quarkus
+    artifactId_quarkus-agroal: quarkus-agroal
+
+    groupId_quarkus-jdbc-postgresql: io.quarkus
+    artifactId_quarkus-jdbc-postgresql: quarkus-jdbc-postgresql
+
+    groupId_kie-addons-quarkus-persistence-jdbc: org.kie
+    artifactId_kie-addons-quarkus-persistence-jdbc: kie-addons-quarkus-persistence-jdbc
+
     #
     # URLs 
     #
@@ -160,6 +171,7 @@ asciidoc:
     ocp_knative_serving_url: https://docs.openshift.com/container-platform/4.12/serverless/install/installing-knative-serving.html
     ocp_knative_eventing_url: https://docs.openshift.com/container-platform/4.12/serverless/install/installing-knative-eventing.html
     ocp_kn_cli_url: https://docs.openshift.com/container-platform/4.12/serverless/install/installing-kn.html
+    k8n_secrets_url: https://kubernetes.io/docs/concepts/configuration/secret
 
     #
     # xreferences to documents within the documentation

serverlessworkflow/modules/ROOT/assets/images/persistence/Persistence-Types.drawio

@@ -0,0 +1,73 @@
+<mxfile host="Electron" modified="2024-05-21T09:18:40.035Z" agent="Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/24.4.0 Chrome/120.0.6099.109 Electron/28.1.0 Safari/537.36" etag="H0YQd7mQeqnJeK-5HK6e" version="24.4.0" type="device">
+  <diagram name="Page-1" id="CsZ2FxxG6tZcgXgf0lRF">
+    <mxGraphModel dx="1098" dy="502" grid="0" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="850" pageHeight="1100" math="0" shadow="0">
+      <root>
+        <mxCell id="0" />
+        <mxCell id="1" parent="0" />
+        <mxCell id="QGvM4vl__vyeh6SA8aqo-2" value="Workflow runtime persistence" style="rounded=1;whiteSpace=wrap;html=1;" parent="1" vertex="1">
+          <mxGeometry x="115.5" y="109" width="179" height="40" as="geometry" />
+        </mxCell>
+        <mxCell id="QGvM4vl__vyeh6SA8aqo-8" value="" style="shape=cylinder3;whiteSpace=wrap;html=1;boundedLbl=1;backgroundOutline=1;size=15;" parent="1" vertex="1">
+          <mxGeometry x="175" y="177" width="60" height="47" as="geometry" />
+        </mxCell>
+        <mxCell id="QGvM4vl__vyeh6SA8aqo-14" value="" style="endArrow=classic;html=1;rounded=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;dashed=1;exitX=0;exitY=0.5;exitDx=0;exitDy=0;" parent="1" source="QGvM4vl__vyeh6SA8aqo-21" target="QGvM4vl__vyeh6SA8aqo-2" edge="1">
+          <mxGeometry width="50" height="50" relative="1" as="geometry">
+            <mxPoint x="357.5" y="97" as="sourcePoint" />
+            <mxPoint x="357.5" y="151" as="targetPoint" />
+            <Array as="points">
+              <mxPoint x="206" y="67" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="QGvM4vl__vyeh6SA8aqo-21" value="Workflow instance" style="rounded=0;whiteSpace=wrap;html=1;" parent="1" vertex="1">
+          <mxGeometry x="303" y="37" width="120" height="60" as="geometry" />
+        </mxCell>
+        <mxCell id="NtIaZSLPTitUS9Ow5RH7-1" value="Data Index persistence" style="rounded=1;whiteSpace=wrap;html=1;" parent="1" vertex="1">
+          <mxGeometry x="430" y="109" width="179" height="40" as="geometry" />
+        </mxCell>
+        <mxCell id="NtIaZSLPTitUS9Ow5RH7-2" value="" style="endArrow=classic;html=1;rounded=0;dashed=1;" parent="1" source="QGvM4vl__vyeh6SA8aqo-21" target="NtIaZSLPTitUS9Ow5RH7-1" edge="1">
+          <mxGeometry width="50" height="50" relative="1" as="geometry">
+            <mxPoint x="448" y="54" as="sourcePoint" />
+            <mxPoint x="541" y="132" as="targetPoint" />
+            <Array as="points">
+              <mxPoint x="520" y="67" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="NtIaZSLPTitUS9Ow5RH7-5" value="" style="endArrow=classic;startArrow=classic;html=1;rounded=0;dashed=1;entryX=0.5;entryY=1;entryDx=0;entryDy=0;" parent="1" source="QGvM4vl__vyeh6SA8aqo-8" target="QGvM4vl__vyeh6SA8aqo-2" edge="1">
+          <mxGeometry width="50" height="50" relative="1" as="geometry">
+            <mxPoint x="200" y="227" as="sourcePoint" />
+            <mxPoint x="200" y="187" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="NtIaZSLPTitUS9Ow5RH7-7" value="" style="endArrow=classic;startArrow=classic;html=1;rounded=0;dashed=1;entryX=0.5;entryY=1;entryDx=0;entryDy=0;" parent="1" source="NtIaZSLPTitUS9Ow5RH7-8" target="NtIaZSLPTitUS9Ow5RH7-1" edge="1">
+          <mxGeometry width="50" height="50" relative="1" as="geometry">
+            <mxPoint x="516" y="235" as="sourcePoint" />
+            <mxPoint x="521" y="182" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="NtIaZSLPTitUS9Ow5RH7-8" value="" style="shape=cylinder3;whiteSpace=wrap;html=1;boundedLbl=1;backgroundOutline=1;size=15;" parent="1" vertex="1">
+          <mxGeometry x="488.5" y="177" width="60" height="47" as="geometry" />
+        </mxCell>
+        <mxCell id="2djzuOXhbR6o8aeaAMRS-1" value="" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;" parent="1" vertex="1">
+          <mxGeometry x="633" y="125.25" width="7.5" height="7.5" as="geometry" />
+        </mxCell>
+        <mxCell id="2djzuOXhbR6o8aeaAMRS-6" value="" style="endArrow=none;html=1;rounded=0;entryX=1;entryY=0.5;entryDx=0;entryDy=0;exitX=0;exitY=0.5;exitDx=0;exitDy=0;" parent="1" source="2djzuOXhbR6o8aeaAMRS-1" target="NtIaZSLPTitUS9Ow5RH7-1" edge="1">
+          <mxGeometry width="50" height="50" relative="1" as="geometry">
+            <mxPoint x="538" y="197" as="sourcePoint" />
+            <mxPoint x="588" y="147" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="2djzuOXhbR6o8aeaAMRS-8" value="&lt;i style=&quot;font-size: 10px;&quot;&gt;&lt;font style=&quot;font-size: 10px;&quot;&gt;graphql&amp;nbsp;&lt;/font&gt;&lt;/i&gt;" style="text;html=1;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=10;" parent="1" vertex="1">
+          <mxGeometry x="616" y="125.25" width="60" height="30" as="geometry" />
+        </mxCell>
+        <mxCell id="2djzuOXhbR6o8aeaAMRS-11" value="&lt;font style=&quot;font-size: 10px;&quot;&gt;workflow instance snapshots&lt;/font&gt;&lt;div style=&quot;font-size: 10px;&quot;&gt;&lt;font style=&quot;font-size: 10px;&quot;&gt;(internal format)&lt;/font&gt;&lt;/div&gt;" style="text;html=1;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=10;" parent="1" vertex="1">
+          <mxGeometry x="139.25" y="229" width="131.5" height="30" as="geometry" />
+        </mxCell>
+        <mxCell id="2djzuOXhbR6o8aeaAMRS-13" value="&lt;font style=&quot;font-size: 10px;&quot;&gt;workflow instance snapshots&lt;/font&gt;&lt;div style=&quot;font-size: 10px;&quot;&gt;&lt;font style=&quot;font-size: 10px;&quot;&gt;(queryable format)&lt;/font&gt;&lt;/div&gt;" style="text;html=1;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=10;" parent="1" vertex="1">
+          <mxGeometry x="453.75" y="229" width="131.5" height="30" as="geometry" />
+        </mxCell>
+      </root>
+    </mxGraphModel>
+  </diagram>
+</mxfile>

serverlessworkflow/modules/ROOT/pages/cloud/operator/global-configuration.adoc

@@ -33,6 +33,17 @@ You can freely edit any of the options in the key `controllers_cfg.yaml` entry.
 | `dataIndexEphemeralTag` | empty | The Data Index image without persistence to use, if empty the operator will use the default Apache Community one based on the current operator's version.
 | `sonataFlowBaseBuilderImageTag` | empty | {product_name} base builder image used in the internal Dockerfile to build workflow applications in preview profile. If empty the operator will use the default Apache Community one based on the current operator's version.
 | `sonataFlowDevModeImageTag` | empty | The image to use to deploy {product_name} workflow images in devmode profile. If empty the operator will use the default Apache Community one based on the current operator's version.
+| `builderConfigMapName` | sonataflow-operator-builder-config | The default name of the builder configMap in the operator's namespace.
+| `postgreSQLPersistenceExtensions` | next column
+| Quarkus extensions required for workflows persistence. These extensions are used by the {operator_name} builder in cases where the workflow being built has configured xref:cloud/operator/using-persistence.adoc[postgresql persistence].
+
+`Default values`:
+
+{groupId_quarkus-agroal}:{artifactId_quarkus-agroal}:{quarkus_version}
+
+{groupId_quarkus-jdbc-postgresql}:{artifactId_quarkus-jdbc-postgresql}:{quarkus_version}
+
+{groupId_kie-addons-quarkus-persistence-jdbc}:{artifactId_kie-addons-quarkus-persistence-jdbc}:{kogito_version}
 
 |===