From fa28fa57d68eaaee02733e1d86b5ec8e727455e1 Mon Sep 17 00:00:00 2001
From: C T <215163593+catplat@users.noreply.github.com>
Date: Thu, 16 Oct 2025 14:36:55 -0400
Subject: [PATCH 1/3] Add Valkey info

---
 shared/data/registry.json | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/shared/data/registry.json b/shared/data/registry.json
index fcab5e55c9..24a0177e89 100644
--- a/shared/data/registry.json
+++ b/shared/data/registry.json
@@ -1247,6 +1247,35 @@
       "deprecated": []
     }
   },
+  "valkey": {
+    "description": "",
+    "repo_name": "valkey",
+    "disk": false,
+    "docs": {
+      "relationship_name": "valkey",
+      "service_name": "valkey",
+      "url": "/add-services/valkey.html"
+    },
+    "endpoint": "http+stats",
+    "min_disk_size": null,
+    "configuration": "    configuration:\n        vcl: !include\n            type: string\n            path: config.vcl",
+    "service_relationships": "application: 'app:http'",
+    "name": "Valkey",
+    "runtime": false,
+    "type": "valkey",
+    "versions": {
+      "supported": [
+        "8.0"
+      ],
+      "deprecated": []
+    },
+    "versions-dedicated-gen-2": {
+      "supported": [
+        "8.0"
+      ],
+      "deprecated": []
+    }
+  },
   "varnish": {
     "description": "",
     "repo_name": "varnish",

From 7226a712b2eba7892ebd141daa0069268b1bcbbe Mon Sep 17 00:00:00 2001
From: C T <215163593+catplat@users.noreply.github.com>
Date: Thu, 16 Oct 2025 14:37:10 -0400
Subject: [PATCH 2/3] Update topics to use registry.json

---
 sites/platform/src/add-services/valkey.md | 62 +++++++++++++++++------
 sites/upsun/src/add-services/valkey.md    | 38 +++++++-------
 2 files changed, 67 insertions(+), 33 deletions(-)

diff --git a/sites/platform/src/add-services/valkey.md b/sites/platform/src/add-services/valkey.md
index dc3dd690ee..a9dff2d293 100644
--- a/sites/platform/src/add-services/valkey.md
+++ b/sites/platform/src/add-services/valkey.md
@@ -23,13 +23,44 @@ You can select the major and minor version.
 
 Patch versions are applied periodically for bug fixes and the like. When you deploy your app, you always get the latest available patches.
 
-All products support the 8.0 version of Valkey.
-
-
-| Grid            | Dedicated Gen 2 |
-| --------------- | --------------- |
-| **8.0**         | **8.0**         |
-
+<table>
+    <thead>
+        <tr>
+            <th>Grid</th>
+            <th>Dedicated Gen 2</th>
+        </tr>
+    </thead>
+    <tbody>
+        <tr>
+            <td>{{< image-versions image="valkey" status="supported" environment="grid" >}}</td>
+            <td>{{< image-versions image="valkey" status="supported" environment="dedicated-gen-2" >}}</thd>
+        </tr>
+    </tbody>
+</table>
+
+<!-- uncomment this section when Upsun deprecates Valkey v8
+### Deprecated versions
+
+The following versions are [deprecated](/glossary.html#deprecated-versions).
+They're available, but they aren't receiving security updates from upstream and aren't guaranteed to work.
+They'll be removed in the future,
+so migrate to one of the [supported versions](#supported-versions).
+
+<table>
+    <thead>
+        <tr>
+            <th>Grid</th>
+            <th>Dedicated Gen 2</th>
+        </tr>
+    </thead>
+    <tbody>
+        <tr>
+            <td>{{< image-versions image="valkey" status="deprecated" environment="grid" >}}</td>
+            <td>{{< image-versions image="valkey" status="deprecated" environment="dedicated-gen-2" >}}</thd>
+        </tr>
+    </tbody>
+</table>
+-->
 
 ## Service types
 
@@ -59,7 +90,7 @@ So your apps should only rely on the `{{% vendor/prefix %}}_RELATIONSHIPS` envir
   "path": null,
   "query": [],
   "password": null,
-  "type": "valkey:8.0",
+  "type": "valkey:{{% latest "valkey" %}}",
   "public": false,
   "host_mapped": false
 }
@@ -365,7 +396,7 @@ runtime:
 ```yaml {configFile="services"}
 # The name of the service container. Must be unique within a project.
 valkey:
-  type: valkey:8.0
+  type: valkey:{{% latest "valkey" %}}
   disk: 256
 ```
 
@@ -426,7 +457,7 @@ For example, if you define a `valkey-persistent` database as follows:
 
 ```yaml {configFile="services"}
 postgresql:
-  type: "valkey-persistent:8.0"
+  type: "valkey-persistent:{{% latest "valkey" %}}"
   disk: 2048
   configuration:
     databases:
@@ -474,7 +505,7 @@ To customize those cache cleanups, set up an eviction policy such as the followi
 services:
   # The name of the service container. Must be unique within a project.
   valkey:
-    type: "valkey:8.0"
+    type: "valkey:{{% latest "valkey" %}}"
     configuration:
       maxmemory_policy: allkeys-lfu
 ```
@@ -577,7 +608,7 @@ applications:
 services:
   # The name of the service container. Must be unique within a project.
   valkeysession:
-    type: "valkey-persistent:8.0"
+    type: "valkey-persistent:{{% latest "valkey" %}}"
 ```
 
 <--->
@@ -622,7 +653,7 @@ applications:
 services:
   # The name of the service container. Must be unique within a project.
   valkeysession:
-    type: "valkey-persistent:8.0"
+    type: "valkey-persistent:{{% latest "valkey" %}}"
 ```
 
 {{< /codetabs >}}
@@ -639,10 +670,9 @@ my_service_name:
 
 with the following:
 
-```
-json
+```json
 my_service_name:
-  type: valkey-persistent:8.0
+  type: valkey-persistent:{{% latest "valkey" %}}
   disk: 256
 ```
 
diff --git a/sites/upsun/src/add-services/valkey.md b/sites/upsun/src/add-services/valkey.md
index a487700f65..47056cf52d 100644
--- a/sites/upsun/src/add-services/valkey.md
+++ b/sites/upsun/src/add-services/valkey.md
@@ -17,7 +17,12 @@ You can select the major and minor version.
 
 Patch versions are applied periodically for bug fixes and the like. When you deploy your app, you always get the latest available patches.
 
-- 8.0
+{{< image-versions image="valkey" status="supported" environment="grid" >}}
+<!-- uncomment this when Upsun deprecates Valkey v8.0 
+{{% deprecated-versions %}}
+
+{{< image-versions image="valkey" status="deprecated" environment="grid" >}}
+-->
 
 ## Service types
 
@@ -56,7 +61,7 @@ VALKEY_REL=valkey
 VALKEY_PATH=
 VALKEY_QUERY={}
 VALKEY_PASSWORD=
-VALKEY_TYPE=valkey:8.0
+VALKEY_TYPE=valkey:{{% latest "valkey" %}}
 VALKEY_PUBLIC=false
 VALKEY_HOST_MAPPED=false
 ```
@@ -86,7 +91,7 @@ The structure of the `PLATFORM_RELATIONSHIPS` environment variable can be obtain
       "epoch": 0,
       "rel": "valkey",
       "scheme": "valkey",
-      "type": "valkey:8.0",
+      "type": "valkey:{{% latest "valkey" %}}",
       "public": false
     }
 ```
@@ -128,9 +133,9 @@ To switch from persistent to ephemeral Valkey, set up a new service with a diffe
 - Disk size
 - The amount of memory allocated to the service container
 
-For instance, if your Valkey container has 3072 MB of disk space and 1024 MB of memory,only 512 MB of RAM are actually available to the service (3072/6 = 512).
+For instance, if your Valkey container has 3072 MB of disk space and 1024 MB of memory, only 512 MB of RAM are actually available to the service (3072/6 = 512).
 
-But if your Valkey container has 3072 MB of disk space and 256 MB of memory,only 256 MB of Valkey are actually available to the service (as per the container limit).
+But if your Valkey container has 3072 MB of disk space and 256 MB of memory, only 256 MB of Valkey are actually available to the service (as per the container limit).
 
 {{% /note %}}
 
@@ -291,7 +296,7 @@ applications:
 services:
     # The name of the service container. Must be unique within a project.
     valkey:
-      valkey: valkey-persistent: 8.0
+      valkey: valkey-persistent: {{% latest "valkey" %}}"
 ```
 
 <--->
@@ -324,7 +329,7 @@ applications:
 services:
   # The name of the service container. Must be unique within a project.
   valkey:
-    type: valkey-persistent: 8.0
+    type: valkey-persistent:{{% latest "valkey" %}}"
 ```
 
 {{< /codetabs >}}
@@ -518,7 +523,7 @@ applications:
 services:
   # The name of the service container. Must be unique within a project.
   valkey:
-    type: valkey: 8.0
+    type: valkey: {{% latest "valkey" %}}"
 ```
 
 <--->
@@ -551,7 +556,7 @@ applications:
 services:
   # The name of the service container. Must be unique within a project.
   valkey:
-    type: valkey: 8.0
+    type: valkey: {{% latest "valkey" %}}"
 ```
 
 {{< /codetabs >}}
@@ -588,7 +593,7 @@ applications:
 services:
   # The name of the service container. Must be unique within a project.
   valkey:
-    type: valkey: 8.0
+    type: valkey: {{% latest "valkey" %}}"
 <--->
 
 +++
@@ -618,7 +623,7 @@ applications:
 services:
   # The name of the service container. Must be unique within a project.
   valkey:
-    type: valkey: 8.0
+    type: valkey: {{% latest "valkey" %}}"
 ```
 
 {{< /codetabs >}}
@@ -660,7 +665,7 @@ To customize those cache cleanups, set up an eviction policy such as the followi
 services:
   # The name of the service container. Must be unique within a project.
   valkey:
-    type: "valkey:8.0"
+    type: "valkey:{{% latest "valkey" %}}"
     configuration:
       maxmemory_policy: allkeys-lfu
 ```
@@ -762,7 +767,7 @@ applications:
 services:
   # The name of the service container. Must be unique within a project.
   valkeysession:
-    type: "valkey-persistent:8.0"
+    type: "valkey-persistent:{{% latest "valkey" %}}"
 ```
 
 <--->
@@ -807,7 +812,7 @@ applications:
 services:
   # The name of the service container. Must be unique within a project.
   valkeysession:
-    type: "valkey-persistent:8.0"
+    type: "valkey-persistent:{{% latest "valkey" %}}""
 ```
 
 {{< /codetabs >}}
@@ -824,10 +829,9 @@ my_service_name:
 
 with the following:
 
-```
-json
+```json
 my_service_name:
-  type: valkey-persistent:8.0
+  type: valkey-persistent:{{% latest "valkey" %}}"
   disk: 256
 ```
 

From dcd59cdc82f601c27b33bbcebf3690710da3a865 Mon Sep 17 00:00:00 2001
From: C T <215163593+catplat@users.noreply.github.com>
Date: Mon, 20 Oct 2025 12:25:43 -0400
Subject: [PATCH 3/3] Apply suggestions from code review

Co-authored-by: Paul Gilzow <paul.gilzow@platform.sh>
---
 sites/upsun/src/add-services/valkey.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/sites/upsun/src/add-services/valkey.md b/sites/upsun/src/add-services/valkey.md
index 1cbdfc25b5..bc198d9c9c 100644
--- a/sites/upsun/src/add-services/valkey.md
+++ b/sites/upsun/src/add-services/valkey.md
@@ -18,11 +18,12 @@ You can select the major and minor version.
 Patch versions are applied periodically for bug fixes and the like. When you deploy your app, you always get the latest available patches.
 
 {{< image-versions image="valkey" status="supported" environment="grid" >}}
-<!-- uncomment this when Upsun deprecates Valkey v8.0 
+{{% comment %}} uncomment this when Upsun deprecates Valkey v8.0 {{% /comment %}}
+{{% comment %}}
 {{% deprecated-versions %}}
 
 {{< image-versions image="valkey" status="deprecated" environment="grid" >}}
--->
+{{% /comment %}}
 
 ## Service types