Valkey
The Valkey microservice is an in-memory data structure store, used as a distributed, in-memory key–value database, cache or message broker. Valkey provides thread-safe, distributed caching that supports scalability, high availability through replication and clustering, and secure communication through TLS/SSL. Valkey caches data as key-value pairs that can store various data types, such as strings, hashes, lists, sets, and more. It supports parallel access to cached data for key-based operations.
This microservice is a supporting microservice that other microservices can use for in-cluster storage. It runs in the a1-cache namespace.
This microservice is part of the Topology and Event microservice pipelines. See Understanding Microservice Pipelines in Unified Assurance Concepts for conceptual information.
After deploying this microservice, you can use the default and JSON search modules in FCOM overrides to look up cache entries. You can also optionally deploy the Device Cache Warmup microservice to load devices into the Valkey cache and use the full-text search module in FCOM overrides. See Cache Lookup Properties and Device Cache Warmup for more information.
Valkey Prerequisites
Before deploying the microservice, confirm that a microservice cluster is set up. See Microservice Cluster Setup.
Deploying Valkey
To deploy the microservice, run the following commands:
su - assure1
export WEBFQDN=<WebFQDN>
a1helm install <microservice-release-name> assure1/valkey -n a1-cache --set global.imageRegistry=$WEBFQDN
In the commands:
-
Note that this microservice must be deployed to the a1-cache namespace rather than a zone-specific namespace.
-
<WebFQDN> is the fully-qualified domain name of the primary presentation server for the cluster.
-
<microservice-release-name> is the name to use for the microservice instance. Oracle recommends using the microservice name (valkey) unless you are deploying multiple instances of the microservice to the same cluster.
You can also use the Unified Assurance UI to deploy microservices. See Deploying a Microservice by Using the UI for more information.
Valkey CLI
The microservice includes the valkey-cli application, which interacts directly with the Valkey instance. You can access it by running an interactive shell within the running Valkey instance.
To launch valkey-cli, run the following commands as the assure1 user on the server where Valkey is deployed:
a1k exec -it valkey-master-0 -n a1-cache -- /bin/bash
valkey-cli --tls --cert /certs/a1/User-assure1.crt --key /certs/a1/User-assure1.key --cacert /certs/a1/BundleCA.crt
See CLI in the Valkey documentation for information about running Valkey commands with valkey-cli.