Ordering an In-Memory Key-Value Cache¶
We provision and operate Valkey instances for you. There is no self-service for creating an instance. This page describes how to order one and which options you can choose.
How to Order¶
Open a ticket in our Service Desk. State that you want an In-Memory Key-Value Cache (Valkey) instance and include the information below.
Information to Include¶
| Field | Required | Description | Example |
|---|---|---|---|
| Cluster | Yes | The Contain Platform cluster the instance runs in. | prod1-dc4 |
| Namespace | Yes | The namespace of the application that connects to the instance. | your-application-namespace |
| Deployment mode | Yes | Standalone or Primary-Replica with Sentinel. See Options. | Primary-Replica with Sentinel |
| Memory size | Yes | The maximum dataset size the instance holds in memory. | 2 GiB |
| Persistence | No | Whether data must survive a restart. Caches usually don't need it. | No |
| Technical contact | Yes | The person we contact about the instance. | Name and email |
Options¶
| Option | Choices | Guidance |
|---|---|---|
| Deployment mode | Standalone, or Primary-Replica with Sentinel | Standalone runs a single Valkey instance. It suits development, test, or caching where high availability is not a concern. Primary-Replica with Sentinel runs one primary for writes and one or more replicas for reads. Valkey Sentinel monitors the instances and promotes a replica if the primary becomes unavailable. |
| Replica count | 1 or more, in Primary-Replica mode | More replicas give more read capacity and tolerate more failures. |
| Memory size | Size in GiB | Valkey keeps the full dataset in memory. When the instance is full, the eviction policy decides which keys are removed. |
| Persistence | Off or on | With persistence on, Valkey writes the dataset to disk and reloads it after a restart. |
| Valkey version | Current supported version | We upgrade the version as part of operating the service. |
What You Receive¶
When the instance is ready, we give you its unique identifier. The
Getting Started guide refers to it as <$valkey_name> and
uses it for the network policy, the credentials and the connection address.
Changes and Cancellation¶
To resize, change mode or remove an instance, open a new Service Desk ticket that names the instance and the change you need.
Next Steps¶
- Getting Started shows how to configure network access and connect your application.