Redis

Redis is an open source (BSD licensed), in-memory data structure store, used as a database, cache and message broker. This example shows how it can be managed in Kubernetes with KubeBlocks.

Prerequisites

This example assumes that you have a Kubernetes cluster installed and running, and that you have installed the kubectl command line tool and helm somewhere in your path. Please see the getting started and Installing Helm for installation instructions for your platform.

Also, this example requires kubeblocks installed and running. Here is the steps to install kubeblocks, please replace "$kb_version" with the version you want to use.

# Add Helm repo 
helm repo add kubeblocks https://apecloud.github.io/helm-charts
# If github is not accessible or very slow for you, please use following repo instead
helm repo add kubeblocks https://jihulab.com/api/v4/projects/85949/packages/helm/stable

# Update helm repo
helm repo update

# Get the versions of KubeBlocks and select the one you want to use
helm search repo kubeblocks/kubeblocks --versions
# If you want to obtain the development versions of KubeBlocks, Please add the '--devel' parameter as the following command
helm search repo kubeblocks/kubeblocks --versions --devel

# Create dependent CRDs
kubectl create -f https://github.com/apecloud/kubeblocks/releases/download/v$kb_version/kubeblocks_crds.yaml
# If github is not accessible or very slow for you, please use following command instead
kubectl create -f https://jihulab.com/api/v4/projects/98723/packages/generic/kubeblocks/v$kb_version/kubeblocks_crds.yaml

# Install KubeBlocks
helm install kubeblocks kubeblocks/kubeblocks --namespace kb-system --create-namespace --version="$kb_version"

Examples

Create

Create a redis replication cluster (with an official Redis Sentinel HA) with specified cluster definition

kubectl apply -f examples/redis/cluster.yaml

Starting from kubeblocks 0.9.0, we introduced a more flexible cluster creation method based on components, allowing customization of cluster topology, functionalities and scale according to specific requirements.

Create a redis replication cluster (with an official Redis Sentinel HA) with specified component definition

kubectl apply -f examples/redis/cluster-cmpd.yaml

Or you can create a redis replication cluster (with an official Redis Sentinel HA) with specified cluster definition topology

kubectl apply -f examples/redis/cluster-cd-topology.yaml

Or you want to create a redis sharding cluster (An official distributed Redis) with specified component definition

kubectl apply -f examples/redis/cluster-sharding.yaml

Horizontal scaling

Horizontal scaling out or in specified components replicas in the cluster

kubectl apply -f examples/redis/horizontalscale.yaml

Vertical scaling

Vertical scaling up or down specified components requests and limits cpu or memory resource in the cluster

kubectl apply -f examples/redis/verticalscale.yaml

Expand volume

Increase size of volume storage with the specified components in the cluster

kubectl apply -f examples/redis/volumeexpand.yaml

Restart

Restart the specified components in the cluster

kubectl apply -f examples/redis/restart.yaml

Stop

Stop the cluster and release all the pods of the cluster, but the storage will be reserved

kubectl apply -f examples/redis/stop.yaml

Start

Start the stopped cluster

kubectl apply -f examples/redis/start.yaml

Configure

Configure parameters with the specified components in the cluster

kubectl apply -f examples/redis/configure.yaml

BackupRepo

BackupRepo is the storage repository for backup data, using the full backup and restore function of KubeBlocks relies on BackupRepo

# Create a secret to save the access key
kubectl create secret generic <storage-provider>-credential-for-backuprepo\
  --from-literal=accessKeyId=<ACCESS KEY> \
  --from-literal=secretAccessKey=<SECRET KEY> \
  -n kb-system 
  
kubectl apply -f examples/redis/backuprepo.yaml

Backup

Create a backup for the cluster

kubectl apply -f examples/redis/backup.yaml

Restore

Restore a new cluster from backup

# Get backup connection password
kubectl get backup redis-cluster-backup -ojsonpath='{.metadata.annotations.dataprotection\.kubeblocks\.io\/connection-password}' -n default

kubectl apply -f examples/redis/restore.yaml

Expose

Expose a cluster with a new endpoint

Enable

kubectl apply -f examples/redis/expose-enable.yaml

Disable

kubectl apply -f examples/redis/expose-disable.yaml

Delete

If you want to delete the cluster and all its resource, you can modify the termination policy and then delete the cluster

kubectl patch cluster redis-cluster -p '{"spec":{"terminationPolicy":"WipeOut"}}' --type="merge"

kubectl delete cluster redis-cluster