diff --git a/stable/redis/.helmignore b/stable/redis/.helmignore new file mode 100644 index 0000000000..6b8710a711 --- /dev/null +++ b/stable/redis/.helmignore @@ -0,0 +1 @@ +.git diff --git a/stable/redis/Chart.yaml b/stable/redis/Chart.yaml new file mode 100644 index 0000000000..ae7122aa68 --- /dev/null +++ b/stable/redis/Chart.yaml @@ -0,0 +1,14 @@ +name: redis +version: 0.4.0 +description: Chart for Redis +keywords: +- redis +- keyvalue +- database +home: http://redis.io/ +sources: +- https://github.com/bitnami/bitnami-docker-redis +maintainers: +- name: Bitnami + email: containers@bitnami.com +engine: gotpl diff --git a/stable/redis/README.md b/stable/redis/README.md new file mode 100644 index 0000000000..8bee8ae477 --- /dev/null +++ b/stable/redis/README.md @@ -0,0 +1,81 @@ +# Redis + +[Redis](http://redis.io/) 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; + +```bash +$ helm install stable/redis +``` + +## Introduction + +This chart bootstraps a [Redis](https://github.com/bitnami/bitnami-docker-redis) deployment on a [Kubernetes](http://kubernetes.io) cluster using the [Helm](https://helm.sh) 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`: + +```bash +$ helm install --name my-release stable/redis +``` + +The command deploys Redis on the Kubernetes cluster in the default configuration. The [configuration](#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: + +```bash +$ 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 | `Always` if `imageTag` is `latest`, else `IfNotPresent` | +| `redisPassword` | Redis password | Randomly generated | +| `persistence.enabled` | Use a PVC to persist data | `true` | +| `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` | + +The above parameters map to the env variables defined in [bitnami/redis](http://github.com/bitnami/bitnami-docker-redis). For more information please refer to the [bitnami/redis](http://github.com/bitnami/bitnami-docker-redis) image documentation. + +Specify each parameter using the `--set key=value[,key=value]` argument to `helm install`. For example, + +```bash +$ 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, + +```bash +$ helm install --name my-release -f values.yaml stable/redis +``` + +> **Tip**: You can use the default [values.yaml](values.yaml) + +## Persistence + +The [Bitnami Redis](https://github.com/bitnami/bitnami-docker-redis) image stores the Redis data and configurations at the `/bitnami/redis` path of the container. + +The chart mounts a [Persistent Volume](kubernetes.io/docs/user-guide/persistent-volumes/) volume at this location. The volume is created using dynamic volume provisioning. diff --git a/stable/redis/templates/NOTES.txt b/stable/redis/templates/NOTES.txt new file mode 100644 index 0000000000..62f19c5e22 --- /dev/null +++ b/stable/redis/templates/NOTES.txt @@ -0,0 +1,16 @@ +Redis can be accessed via port 3306 on the following DNS name from within your cluster: +{{ template "fullname" . }}.{{ .Release.Namespace }}.svc.cluster.local + +To get your password run: + + REDIS_PASSWORD=$(printf $(printf '\%o' `kubectl get secret --namespace {{ .Release.Namespace }} {{ template "fullname" . }} -o jsonpath="{.data.redis-password[*]}"`)) + +To connect to your Redis server: + +1. Run a Redis pod that you can use as a client: + + kubectl run {{ template "fullname" . }}-client --rm --tty -i --env REDIS_PASSWORD=$REDIS_PASSWORD --image {{ .Values.image }} -- bash + +2. Connect using the Redis CLI: + + redis-cli -h {{ template "fullname" . }} -a $REDIS_PASSWORD diff --git a/stable/redis/templates/_helpers.tpl b/stable/redis/templates/_helpers.tpl new file mode 100644 index 0000000000..234480de71 --- /dev/null +++ b/stable/redis/templates/_helpers.tpl @@ -0,0 +1,16 @@ +{{/* vim: set filetype=mustache: */}} +{{/* +Expand the name of the chart. +*/}} +{{- define "name" -}} +{{- default .Chart.Name .Values.nameOverride | trunc 24 -}} +{{- end -}} + +{{/* +Create a default fully qualified app name. +We truncate at 24 chars because some Kubernetes name fields are limited to this (by the DNS naming spec). +*/}} +{{- define "fullname" -}} +{{- $name := default .Chart.Name .Values.nameOverride -}} +{{- printf "%s-%s" .Release.Name $name | trunc 24 -}} +{{- end -}} diff --git a/stable/redis/templates/deployment.yaml b/stable/redis/templates/deployment.yaml new file mode 100644 index 0000000000..c97a9b0e41 --- /dev/null +++ b/stable/redis/templates/deployment.yaml @@ -0,0 +1,55 @@ +apiVersion: extensions/v1beta1 +kind: Deployment +metadata: + name: {{ template "fullname" . }} + labels: + app: {{ template "fullname" . }} + chart: "{{ .Chart.Name }}-{{ .Chart.Version }}" + release: "{{ .Release.Name }}" + heritage: "{{ .Release.Service }}" +spec: + template: + metadata: + labels: + app: {{ template "fullname" . }} + spec: + containers: + - name: {{ template "fullname" . }} + image: "{{ .Values.image }}" + imagePullPolicy: {{ default "" .Values.imagePullPolicy | quote }} + env: + - name: REDIS_PASSWORD + valueFrom: + secretKeyRef: + name: {{ template "fullname" . }} + key: redis-password + ports: + - name: redis + containerPort: 6379 + livenessProbe: + exec: + command: + - redis-cli + - ping + initialDelaySeconds: 30 + timeoutSeconds: 5 + readinessProbe: + exec: + command: + - redis-cli + - ping + initialDelaySeconds: 5 + timeoutSeconds: 1 + resources: +{{ toYaml .Values.resources | indent 10 }} + volumeMounts: + - name: redis-data + mountPath: /bitnami/redis + volumes: + - name: redis-data + {{- if .Values.persistence.enabled }} + persistentVolumeClaim: + claimName: {{ template "fullname" . }} + {{- else }} + emptyDir: {} + {{- end -}} diff --git a/stable/redis/templates/pvc.yaml b/stable/redis/templates/pvc.yaml new file mode 100644 index 0000000000..db19bb97d9 --- /dev/null +++ b/stable/redis/templates/pvc.yaml @@ -0,0 +1,14 @@ +{{- if .Values.persistence.enabled }} +kind: PersistentVolumeClaim +apiVersion: v1 +metadata: + name: {{ template "fullname" . }} + annotations: + volume.alpha.kubernetes.io/storage-class: {{ .Values.persistence.storageClass | quote }} +spec: + accessModes: + - {{ .Values.persistence.accessMode | quote }} + resources: + requests: + storage: {{ .Values.persistence.size | quote }} +{{- end }} diff --git a/stable/redis/templates/secrets.yaml b/stable/redis/templates/secrets.yaml new file mode 100644 index 0000000000..3df160e45f --- /dev/null +++ b/stable/redis/templates/secrets.yaml @@ -0,0 +1,16 @@ +apiVersion: v1 +kind: Secret +metadata: + name: {{ template "fullname" . }} + labels: + app: {{ template "fullname" . }} + chart: "{{ .Chart.Name }}-{{ .Chart.Version }}" + release: "{{ .Release.Name }}" + heritage: "{{ .Release.Service }}" +type: Opaque +data: + {{ if .Values.redisPassword }} + redis-password: {{ .Values.redisPassword | b64enc | quote }} + {{ else }} + redis-password: {{ randAlphaNum 10 | b64enc | quote }} + {{ end }} diff --git a/stable/redis/templates/svc.yaml b/stable/redis/templates/svc.yaml new file mode 100644 index 0000000000..d51b4e3e6e --- /dev/null +++ b/stable/redis/templates/svc.yaml @@ -0,0 +1,16 @@ +apiVersion: v1 +kind: Service +metadata: + name: {{ template "fullname" . }} + labels: + app: {{ template "fullname" . }} + chart: "{{ .Chart.Name }}-{{ .Chart.Version }}" + release: "{{ .Release.Name }}" + heritage: "{{ .Release.Service }}" +spec: + ports: + - name: redis + port: 6379 + targetPort: redis + selector: + app: {{ template "fullname" . }} diff --git a/stable/redis/values.yaml b/stable/redis/values.yaml new file mode 100644 index 0000000000..58979abe66 --- /dev/null +++ b/stable/redis/values.yaml @@ -0,0 +1,33 @@ +## Bitnami Redis image version +## ref: https://hub.docker.com/r/bitnami/redis/tags/ +## +image: bitnami/redis:3.2.4-r0 + +## Specify a imagePullPolicy +## 'Always' if imageTag is 'latest', else set to 'IfNotPresent' +## ref: http://kubernetes.io/docs/user-guide/images/#pre-pulling-images +## +# imagePullPolicy: + +## Redis password +## Defaults to a random 10-character alphanumeric string if not set +## ref: https://github.com/bitnami/bitnami-docker-redis#setting-the-server-password-on-first-run +## +# redisPassword: + +## Enable persistence using Persistent Volume Claims +## ref: http://kubernetes.io/docs/user-guide/persistent-volumes/ +## +persistence: + enabled: true + storageClass: generic + accessMode: ReadWriteOnce + size: 8Gi + +## Configure resource requests and limits +## ref: http://kubernetes.io/docs/user-guide/compute-resources/ +## +resources: + requests: + memory: 256Mi + cpu: 100m