Using AwsRedisCluster Custom Resources

WARNING

This is a beta feature available only per request for SAP-internal teams.

The Cloud Manager module offers an AwsRedisCluster Custom Resource Definition (CRD). When you apply an AwsRedisCluster custom resource (CR), it creates an ElastiCache for Redis OSS instance, with cluster mode enabled, that is reachable within your Kubernetes cluster network.

Prerequisites

You have the Cloud Manager module added.

Steps

Minimal Setup

To instantiate Redis and connect the Pod with only the required fields, use the following setup:

1. Create a Redis Cluster.

   NOTE

   The operation may take more than 10 minutes.

   apiVersion: cloud-resources.kyma-project.io/v1beta1
   kind: AwsRedisCluster
   metadata:
     name: awsrediscluster-minimal-example
   spec:
     redisTier: C1
     shardCount: 3

2. Instantiate the redis-cli Pod:

   apiVersion: v1
   kind: Pod
   metadata:
     name: awsrediscluster-minimal-example-probe
   spec:
     containers:
     - name: redis-cli
       image: redis:latest
       command: ["/bin/sleep"]
       args: ["999999999999"]
       env:
       - name: HOST
         valueFrom:
           secretKeyRef:
             key: host
             name: awsrediscluster-minimal-example
       - name: PORT
         valueFrom:
           secretKeyRef:
             key: port
             name: awsrediscluster-minimal-example

3. Execute into the Pod:

   kubectl exec -i -t awsrediscluster-minimal-example-probe -c redis-cli -- sh -c "clear; (bash || ash || sh)"

4. Install and update CA certificates:

   apt-get update && \
     apt-get install -y ca-certificates && \
     update-ca-certificates

5. Run a PING command:

   redis-cli -h $HOST -p $PORT --tls -c PING

   If your setup was successful, you get PONG back from the server.

Advanced Setup

To specify advanced features, such as Redis version, configuration, and maintenance policy, and set up auth, use the following setup:

1. Instantiate Redis.

   NOTE

   The operation may take more than 10 minutes.

   apiVersion: cloud-resources.kyma-project.io/v1beta1
   kind: AwsRedisCluster
   metadata:
     name: awsrediscluster-advanced-example
   spec:
     redisTier: C1
     shardCount: 3
     replicasPerShard: 1
     engineVersion: "7.0"
     authEnabled: true
     parameters:
       maxmemory-policy: volatile-lru
       activedefrag: "yes"
     preferredMaintenanceWindow: sun:23:00-mon:01:30
     autoMinorVersionUpgrade: true

2. Instantiate the redis-cli Pod.

   apiVersion: v1
   kind: Pod
   metadata:
     name: awsrediscluster-advanced-example-probe
   spec:
     containers:
     - name: redis-cli
       image: redis:latest
       command: ["/bin/sleep"]
       args: ["999999999999"]
       env:
       - name: HOST
         valueFrom:
           secretKeyRef:
             key: host
             name: awsrediscluster-advanced-example
       - name: PORT
         valueFrom:
           secretKeyRef:
             key: port
             name: awsrediscluster-advanced-example
       - name: AUTH_STRING
         valueFrom:
           secretKeyRef:
             key: authString
             name: awsrediscluster-advanced-example

3. Execute into the Pod.

   kubectl exec -i -t awsrediscluster-advanced-example-probe -c redis-cli -- sh -c "clear; (bash || ash || sh)"

4. Install and update ca-certificates:

   apt-get update && \
     apt-get install -y ca-certificates && \
     update-ca-certificates

5. Run a PING command.

   redis-cli -h $HOST -p $PORT -a $AUTH_STRING --tls -c PING

   If your setup was successful, you get PONG back from the server.