Skip to content

Latest commit

 

History

History
112 lines (78 loc) · 4.57 KB

File metadata and controls

112 lines (78 loc) · 4.57 KB
Title alwaysopen categories description linkTitle weight
Install Redis Enterprise Helm chart
false
docs
operate
kubernetes
Install the Redis Enterprise for Kubernetes version 7.8.Wisconsin using helm charts.
Helm
11

Helm charts provide a simple way to install the Redis Enterprise for Kubernetes operator in just a few steps. For more information about Helm, go to https://helm.sh/docs/.

{{}} This feature is currently in public preview and is not supported on production workloads. Only new installations of the Redis operator are supported at this time. The steps for [creating the RedisEnterpriseCluster (REC)]({{<relref "operate/kubernetes/deployment/quick-start/#create-a-redis-enterprise-cluster-rec">}}) and other custom resources remain the same.{{}}

Prerequisites

Install

  1. Add the redis repository.

    helm repo add redis-enterprise https://helm.redis.io/
  2. Install the Helm chart into a new namespace.

    helm install <operator-name> redis/redis-enterprise-operator \
        -- version <release-name> \
        -- namespace <namespace-name> \
        -- create-namespace

To install with Openshift, add --set openshift.mode=true.

To monitor the installation add the --debug flag. The installation runs several jobs synchronously and may take few minutes to complete.

Install from local directory

  1. Find the latest release on the redis-enterprise-k8s-docs Github and download the tar.gz source code into a local directory.

  2. Install the Helm chart from your local directory.

    helm install <release-name> <path-to-chart> \
        -- namespace <namespace-name> \
        -- create-namespace

To install with Openshift, add --set openshift.mode=true.

To monitor the installation add the --debug flag. The installation runs several jobs synchronously and may take few minutes to complete.

Specify values during install

  1. View configurable values with helm show values redis/redis --version <release-name>.

  2. Install the Helm chart, overriding specific value defaults using --set.

    helm install <operator-name> redis/redis-enterprise-operator \
        -- version <release-name> \
        -- namespace <namespace-name> \
        -- create-namespace
        --set <key1>=<value1> \
        --set <key2>=<value2>

Install with values file

  1. View configurable values with helm show values redis/redis-enterprise-operator --version <release-name>.

  2. Create a YAML file containing the configuration values you want to set.

  3. Create a YAML file to specify the values you want to configure.

  4. Install the chart with the --values option.

    helm install <operator-name> redis/redis-enterprise-operator \
        -- version <release-name> \
        -- namespace <namespace-name> \
        -- create-namespace \
        -- values <path-to-values-file>

Uninstall

  1. Delete any custom resources managed by the operator. See [Delete custom resources]({{<relref "content/operate/kubernetes/re-clusters/delete-custom-resources.md">}}) for detailed steps. Custom resources must be deleted in the correct order to avoid errors.

  2. Uninstall the helm chart.

    helm uninstall <release-name>

This removes all Kubernetes resources associated with the chart and deletes the release.

{{}}Custom Resource Definitions (CRDs) installed by the chart are not removed during chart uninstallation. To remove them manually after uninstalling the chart, run kubectl delete crds -l app=redis-enterprise.{{}}

Known limitations

  • Only new installations of the Redis operator are supported at this time. The steps for [creating the RedisEnterpriseCluster (REC)]({{<relref "operate/kubernetes/deployment/quick-start/#create-a-redis-enterprise-cluster-rec">}}) and other custom resources remain the same.
  • Upgrades and migrations are not supported.
  • The chart doesn't include configuration options for multiple namespaces, rack-awareness, and Vault integration. The steps for configuring these options remains the same.
  • The chart has had limited testing in advanced setups, including Active-Active configurations, air-gapped deployments, and IPv6/dual-stack environments.