Update HA guides to use the new ISPN config options

Closes #26776

Signed-off-by: Michal Hajas <mhajas@redhat.com>

docs/guides/high-availability/connect-keycloak-to-external-infinispan.adoc

@@ -53,7 +53,7 @@ include::examples/generated/keycloak-ispn.yaml[tag=keycloak-ispn-configmap]
 include::examples/generated/keycloak-ispn.yaml[tag=keycloak-ispn-secret]
 ----
 
-. Extend the {project_name} Custom Resource with `additionalOptions` and extend the `podTemplate` as shown below.
+. Extend the {project_name} Custom Resource with `additionalOptions` as shown below.
 +
 [NOTE]
 ====
@@ -67,14 +67,11 @@ Administrators should leave those configurations untouched.
 ----
 include::examples/generated/keycloak-ispn.yaml[tag=keycloak-ispn]
 ----
-<1> Custom cache configuration XML file definition, which includes configuration for remote or embedded {jdgserver_name} store.
+<1> The `name` and `key` of the ConfigMap with the {jdgserver_name} Cache configuration XML created in the previous step.
 <2> The hostname and port of the remote cache {jdgserver_name} cluster.
 <3> The credentials required, username and password, to access the remote cache {jdgserver_name} cluster.
-<4> Mounting the cache configuration Volume in Kubernetes.
-However, matching the `jboss.site.name` with the external {jdgserver_name} deployment site name helps debugging possible future issues.
+<4> The `spi-connections-infinispan-quarkus-site-name` is an arbitrary {jdgserver_name} site name which {project_name} needs for its embedded {jdgserver_name} deployment when a remote store is used.
+This site-name is related only to the embedded {jdgserver_name} and does not need to match any value from the external {jdgserver_name} deployment.
 If you are using multiple sites for {project_name} in a cross-DC setup such as <@links.ha id="deploy-infinispan-kubernetes-crossdc" />, the site name must be different in each site.
-<5> `jboss.site.name` is an arbitrary {jdgserver_name} site name which {project_name} needs for its embedded {jdgserver_name} deployment when a remote store is used.
-This site name is related only to the embedded {jdgserver_name} and does not need to match any value from the external {jdgserver_name} deployment.
-<6> Defining the cache configuration Volume using the already created ConfigMap in Kubernetes.
 
 </@tmpl.guide>

docs/guides/high-availability/examples/generated/keycloak-ispn.yaml

@@ -737,13 +737,17 @@ spec:
     enabled:
       - multi-site # <2>
   # tag::keycloak-ispn[]
+  cache:
+    configMapFile:
+      name: kcb-infinispan-cache-config # <1>
+      key: kcb-infinispan-cache-remote-store-config.xml # <1>
+  # end::keycloak-ispn[]
+  # tag::keycloak-ispn[]
   additionalOptions:
-    - name: cache-config-file # <1>
-      value: kcb-infinispan-cache-remote-store-config.xml
+    # end::keycloak-ispn[]
+
     # tag::keycloak-queue-size[]
     - name: http-max-queued-requests
-      # end::keycloak-ispn[]
-
       value: "1000"
     # end::keycloak-queue-size[]
     - name: log-console-output
@@ -763,27 +767,22 @@ spec:
       secret:
         name: remote-store-secret
         key: password
-        # end::keycloak-ispn[]
+    - name: spi-connections-infinispan-quarkus-site-name # <4>
+      value: keycloak
+      # end::keycloak-ispn[]
   http:
     tlsSecret: keycloak-tls-secret
   instances: 1
-  # tag::keycloak-ispn[]
   unsupported:
     podTemplate:
       # end::keycloak[]
-      # end::keycloak-ispn[]
       metadata:
         annotations:
-          checksum/config: c73adcb155290b2da36c94852649862ca6c5ceab4be2f51bde509cd07276ca3d-4832924b47210161956e3b1718daf07ff52d801545186a76c391485eaf1897d3--56f92cd9012613402e2a7a61aded0f218d077b8c6345b22922ca7bf1a5c64984-v1.27.0
+          checksum/config: 4ea7d5f76d813828d0306098e48de65564756d4629233b2f7125709bcac6b4dc-4832924b47210161956e3b1718daf07ff52d801545186a76c391485eaf1897d3--56f92cd9012613402e2a7a61aded0f218d077b8c6345b22922ca7bf1a5c64984-v1.27.0
       # tag::keycloak[]
-      # tag::keycloak-ispn[]
       spec:
-        # end::keycloak-ispn[]
-
-        # tag::keycloak-ispn[]
         containers:
           - env:
-              # end::keycloak-ispn[]
               - name: 'QUARKUS_THREAD_POOL_MAX_THREADS' # <4>
                 value: "200"
               # end::keycloak[]
@@ -801,13 +800,9 @@ spec:
                     key: password
                     optional: false
                 # tag::keycloak[]
-              # tag::keycloak-ispn[]
               - name: JAVA_OPTS_APPEND # <5>
-                value: >
-                  -Djboss.site.name=keycloak
-
+                value: ""
                 # end::keycloak[]
-                # end::keycloak-ispn[]
             ports:
             # tag::keycloak[]
             resources:
@@ -824,25 +819,11 @@ spec:
             #   exec:
             #     command:
             #       - 'true'
-            # tag::keycloak-ispn[]
             volumeMounts:
-              - name: kcb-infinispan-cache-config # <4>
-                mountPath: /opt/keycloak/conf/kcb-infinispan-cache-remote-store-config.xml
-                subPath: kcb-infinispan-cache-remote-store-config.xml
-                readOnly: true
-                # end::keycloak-ispn[]
               - name: keycloak-providers
                 mountPath: /opt/keycloak/providers
                 readOnly: true
-        # tag::keycloak-ispn[]
         volumes:
-          - name: kcb-infinispan-cache-config # <6>
-            configMap:
-              name: kcb-infinispan-cache-config
-              items:
-                - key: kcb-infinispan-cache-remote-store-config.xml
-                  path: kcb-infinispan-cache-remote-store-config.xml
-            # end::keycloak-ispn[]
           - name: keycloak-providers
             configMap:
               name: keycloak-providers