[release-1.6] RHIDP-5184 - added steps to _Configuring Redis cache_ (#1173)

* RHIDP-5184 - added steps to _Configuring Redis cache_

Signed-off-by: Fabrice Flore-Thébault <[email protected]>

* Apply suggestions from code review

Co-authored-by: Copilot <[email protected]>

* Update modules/configuring/proc-installing-and-configuring-redis-cache.adoc

Co-authored-by: Kim Tsao <[email protected]>

* Update modules/configuring/proc-installing-and-configuring-redis-cache.adoc

Co-authored-by: Kim Tsao <[email protected]>

* Update modules/configuring/proc-installing-and-configuring-redis-cache.adoc

* Update modules/configuring/proc-installing-and-configuring-redis-cache.adoc

* Update modules/configuring/proc-installing-and-configuring-redis-cache.adoc

* Update modules/configuring/proc-installing-and-configuring-redis-cache.adoc

* Update modules/configuring/proc-installing-and-configuring-redis-cache.adoc

* Update modules/configuring/proc-installing-and-configuring-redis-cache.adoc

* language review

Signed-off-by: Fabrice Flore-Thébault <[email protected]>

* language review

Signed-off-by: Fabrice Flore-Thébault <[email protected]>

* Update modules/configuring/proc-enabling-the-rhdh-plugin-assets-cache.adoc

Co-authored-by: Judith Magak <[email protected]>

* Update modules/configuring/proc-enabling-the-rhdh-plugin-assets-cache.adoc

Co-authored-by: Judith Magak <[email protected]>

* Update modules/configuring/proc-enabling-the-rhdh-plugin-assets-cache.adoc

Co-authored-by: Judith Magak <[email protected]>

* Update modules/configuring/proc-enabling-the-rhdh-plugin-assets-cache.adoc

Co-authored-by: Judith Magak <[email protected]>

---------

Signed-off-by: Fabrice Flore-Thébault <[email protected]>
Co-authored-by: Fabrice Flore-Thébault <[email protected]>
Co-authored-by: Copilot <[email protected]>
Co-authored-by: Kim Tsao <[email protected]>
Co-authored-by: Judith Magak <[email protected]>

Author: 5 people

modules/configuring/proc-enabling-the-rhdh-plugin-assets-cache.adoc

@@ -0,0 +1,37 @@
+[id="enabling-the-rhdh-plugin-assets-cache_{context}"]
+= Enabling the {product} plugin assets cache
+
+By default, {product} does not cache plugin assets.
+You can use a Redis cache store to improve {product-short} performance and reliability.
+Configured plugins in {product-short} receive dedicated cache connections, which are powered by the Keyv Redis client.
+
+.Prerequisites
+* You have installed {product}.
+* You have an active Redis server.
+For more information on setting up an external Redis server, see the link:https://www.redis.io/docs/latest/[`official Redis documentation`].
+
+.Procedure
+. Enable the {product-short} cache by defining Redis as the cache store type and entering your Redis server connection URL in your `{my-app-config-file}` file.
++
+.`{my-app-config-file}` file fragment
+[source,yaml,subs="+quotes"]
+----
+backend:
+  cache:
+    store: redis
+    connection: redis://user:[email protected]:6379
+----
+
+. Enable the cache for Techdocs by adding the `techdocs.cache.ttl` setting in your `{my-app-config-file}` file.
+This setting specifies how long, in milliseconds, a statically built asset should stay in the cache.
++
+.`{my-app-config-file}` file fragment
+[source,yaml]
+----
+techdocs:
+  cache:
+    ttl: 3600000
+----
+
+TIP: Optionally, enable the cache for unsupported plugins that support this feature.
+See their respective documentation for details.

modules/dynamic-plugins/proc-installing-and-configuring-redis-cache.adoc

@@ -36,5 +36,5 @@ include::modules/dynamic-plugins/con-dynamic-plugins-cache.adoc[ leveloffset=+1]
 include::assemblies/assembly-configuring-default-secret-pvc-mounts.adoc[leveloffset=+1]
 
 
-include::modules/dynamic-plugins/proc-installing-and-configuring-redis-cache.adoc[leveloffset=+1]
+include::modules/configuring/proc-enabling-the-rhdh-plugin-assets-cache.adoc[leveloffset=+1]