Configurable PVC mounting

Author: GitHub Actions

modules/configuring-external-databases/proc-configuring-pvc-mounts.adoc

@@ -0,0 +1,82 @@
+:_mod-docs-content-type: PROCEDURE
+[id="proc-configuring-pvc-mounts_{context}"]
+= Configuring Persistent Volume Claim (PVC) mounts
+
+You can configure which containers the Persistent Volume Claim (PVC) mounts to by adding `rhdh.redhat.com/containers` to your configuration file. You can configure multiple secrets by using annotations to specify mount paths for each secret and target specific containers where the secrets should mount. Adding annotations ensures flexible storage and secrets management across different containers. The `default-config/deployment.yaml` file defines the dynamic plugins directory, as shown in the following example:
+
+[source,yaml]
+----
+- ephemeral:
+    volumeClaimTemplate:
+      spec:
+        accessModes:
+          - ReadWriteOnce
+        resources:
+          requests:
+            storage: 2Gi
+  name: dynamic-plugins-root
+----
+
+.Procedure
+
+. Specify the container where the PVC mounts by adding the `rhdh.redhat.com/mount-path` annotation to your configuration as shown in the following example:
++
+.Example specifying where the PVC mounts
+[source,yaml,subs="+attributes,+quotes"]
+----
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+  name: _<my_claim>_
+  annotations:
+    rhdh.redhat.com/mount-path: /mount/path/from/annotation
+----
+where:
+
+`rhdh.redhat.com/mount-path`:: Specifies which container the PVC mounts to.
+<my_claim>:: Specifies the PVC to mount.
+
+. Specify the container where the Secret mounts by adding the `rhdh.redhat.com/mount-path` annotation to your configuration as shown in the following example:
++
+.Example specifying where the Secret mounts
+[source,yaml,subs="+attributes,+quotes"]
+----
+apiVersion: v1
+kind: Secret
+metadata:
+  name: _<my_secret>_
+  annotations:
+    rhdh.redhat.com/mount-path: /mount/path/from/annotation
+----
+where:
+
+<my_secret>:: Specifies the Secret name.
+
+. Use the following configuration to mount PVCs to all containers:
++
+.Example configuration for mounting to all containers
+[source,yaml,subs="+attributes,+quotes"]
+----
+metadata:
+  name: _<my_secret>_
+  annotations:
+    rhdh.redhat.com/containers: `*`
+----
++
+[IMPORTANT]
+====
+Set `rhdh.redhat.com/containers` to `*` to mount it to all containers in the deployment.
+====
+
+. Optional: Use commas to separate the list of containers to mount to as shown in the following example:
++
+.Example configuration for separating the list of containers
+[source,yaml,subs="+attributes,+quotes"]
+----
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+  name: myclaim
+  annotations:
+    rhdh.redhat.com/containers: "init-dynamic-plugins,backstage-backend"
+----

modules/configuring-external-databases/proc-configuring-pvc-secret-mounting.adoc

@@ -33,7 +33,7 @@ include::modules/installation/proc-configuring-an-rhdh-instance-with-tls-in-kube
 include::modules/dynamic-plugins/con-dynamic-plugins-cache.adoc[ leveloffset=+1]
 
 
-include::modules/configuring-external-databases/proc-configuring-pvc-secret-mounting.adoc[leveloffset=+1]
+include::modules/configuring-external-databases/proc-configuring-pvc-mounts.adoc[leveloffset=+1]
 
 
 include::modules/dynamic-plugins/proc-installing-and-configuring-redis-cache.adoc[leveloffset=+1]