Skip to content

Rework Valkey to pull from registry.json #5100

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Oct 20, 2025
Merged

Rework Valkey to pull from registry.json #5100

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
fa28fa5
Add Valkey info
catplat Oct 16, 2025
7226a71
Update topics to use registry.json
catplat Oct 16, 2025
d92ecb8
Merge branch 'main' into 4851-valkey
catplat Oct 16, 2025
cbb80ab
Merge branch 'main' into 4851-valkey
catplat Oct 20, 2025
dcd59cd
Apply suggestions from code review
catplat Oct 20, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 29 additions & 0 deletions shared/data/registry.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1244,6 +1244,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",
Expand Down
62 changes: 46 additions & 16 deletions sites/platform/src/add-services/valkey.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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
}
Expand Down Expand Up @@ -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
```

Expand Down Expand Up @@ -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:
Expand Down Expand Up @@ -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
```
Expand Down Expand Up @@ -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" %}}"
```

<--->
Expand Down Expand Up @@ -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 >}}
Expand All @@ -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
```

Expand Down
39 changes: 22 additions & 17 deletions sites/upsun/src/add-services/valkey.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,13 @@ 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" >}}
{{% comment %}} uncomment this when Upsun deprecates Valkey v8.0 {{% /comment %}}
{{% comment %}}
{{% deprecated-versions %}}

{{< image-versions image="valkey" status="deprecated" environment="grid" >}}
{{% /comment %}}

## Service types

Expand Down Expand Up @@ -56,7 +62,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
```
Expand Down Expand Up @@ -86,7 +92,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
}
```
Expand Down Expand Up @@ -128,9 +134,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 %}}

Expand Down Expand Up @@ -291,7 +297,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" %}}"
```

<--->
Expand Down Expand Up @@ -324,7 +330,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 >}}
Expand Down Expand Up @@ -518,7 +524,7 @@ applications:
services:
# The name of the service container. Must be unique within a project.
valkey:
type: valkey: 8.0
type: valkey: {{% latest "valkey" %}}"
```

<--->
Expand Down Expand Up @@ -551,7 +557,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 >}}
Expand Down Expand Up @@ -588,7 +594,7 @@ applications:
services:
# The name of the service container. Must be unique within a project.
valkey:
type: valkey: 8.0
type: valkey: {{% latest "valkey" %}}"
<--->

+++
Expand Down Expand Up @@ -618,7 +624,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 >}}
Expand Down Expand Up @@ -660,7 +666,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
```
Expand Down Expand Up @@ -762,7 +768,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" %}}"
```

<--->
Expand Down Expand Up @@ -807,7 +813,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 >}}
Expand All @@ -824,10 +830,9 @@ my_service_name:

with the following:

```
json
```json
my_service_name:
type: valkey-persistent:8.0
type: valkey-persistent:{{% latest "valkey" %}}"
disk: 256
```

Expand Down
Loading