* Support setting up redis without password Add usePassword value to control enabling password authentication usePassword false ignores redisPassword and does not set REDIS_PASSWORD * add ALLOW_EMPTY_PASSWORD env - includes metadata and formatting fixes
Redis
Redis is an advanced key-value cache and store. It is often referred to as a data structure server since keys can contain strings, hashes, lists, sets, sorted sets, bitmaps and hyperloglogs.
TL;DR;
$ helm install stable/redis
Introduction
This chart bootstraps a Redis deployment on a Kubernetes cluster using the Helm package manager.
Prerequisites
- Kubernetes 1.4+ with Beta APIs enabled
- PV provisioner support in the underlying infrastructure
Installing the Chart
To install the chart with the release name my-release:
$ helm install --name my-release stable/redis
The command deploys Redis on the Kubernetes cluster in the default configuration. The configuration section lists the parameters that can be configured during installation.
Tip
: List all releases using
helm list
Uninstalling the Chart
To uninstall/delete the my-release deployment:
$ helm delete my-release
The command removes all the Kubernetes components associated with the chart and deletes the release.
Configuration
The following tables lists the configurable parameters of the Redis chart and their default values.
| Parameter | Description | Default |
|---|---|---|
image |
Redis image | bitnami/redis:{VERSION} |
imagePullPolicy |
Image pull policy | IfNotPresent |
redisPassword |
Redis password | Randomly generated |
persistence.enabled |
Use a PVC to persist data | true |
persistence.existingClaim |
Use an existing PVC to persist data | nil |
persistence.storageClass |
Storage class of backing PVC | generic |
persistence.accessMode |
Use volume as ReadOnly or ReadWrite | ReadWriteOnce |
persistence.size |
Size of data volume | 8Gi |
resources |
CPU/Memory resource requests/limits | Memory: 256Mi, CPU: 100m |
metrics.enabled |
Start a side-car prometheus exporter | false |
metrics.image |
Exporter image | oliver006/redis_exporter |
metrics.imageTag |
Exporter image | v0.11 |
metrics.imagePullPolicy |
Exporter image pull policy | IfNotPresent |
metrics.resources |
Exporter resource requests/limit | Memory: 256Mi, CPU: 100m |
The above parameters map to the env variables defined in bitnami/redis. For more information please refer to the bitnami/redis image documentation.
Specify each parameter using the --set key=value[,key=value] argument to helm install. For example,
$ helm install --name my-release \
--set redisPassword=secretpassword \
stable/redis
The above command sets the Redis server password to secretpassword.
Alternatively, a YAML file that specifies the values for the parameters can be provided while installing the chart. For example,
$ helm install --name my-release -f values.yaml stable/redis
Tip
: You can use the default values.yaml
Persistence
The Bitnami Redis image stores the Redis data and configurations at the /bitnami/redis path of the container.
By default, the chart mounts a Persistent Volume volume at this location. The volume is created using dynamic volume provisioning. If a Persistent Volume Claim already exists, specify it during installation.
Existing PersistentVolumeClaim
- Create the PersistentVolume
- Create the PersistentVolumeClaim
- Install the chart
$ helm install --set persistence.existingClaim=PVC_NAME redis
Metrics
The chart optionally can start a metrics exporter for prometheus. The metrics endpoint (port 9121) is not exposed and it is expected that the metrics are collected from inside the k8s cluster using something similar as the described in the example Prometheus scrape configuration.