Skip to content

Commit 8001cd7

Browse files
archive version 7.22
1 parent a0195b5 commit 8001cd7

File tree

72 files changed

+15719
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

72 files changed

+15719
-0
lines changed
Lines changed: 111 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,111 @@
1+
---
2+
Title: Redis Enterprise for Kubernetes
3+
alwaysopen: false
4+
categories:
5+
- docs
6+
- operate
7+
- kubernetes
8+
description: Deploy and manage Redis Enterprise on Kubernetes with the Redis Enterprise operator.
9+
hideListLinks: true
10+
linkTitle: 7.22
11+
weight: 30
12+
bannerText: This documentation applies to version 7.22.
13+
bannerChildren: true
14+
url: '/operate/kubernetes/7.22/'
15+
---
16+
17+
Redis Enterprise for Kubernetes brings Redis Enterprise to Kubernetes environments through the Redis Enterprise operator. You can deploy, scale, and manage Redis Enterprise clusters and databases by using native Kubernetes resources and workflows.
18+
19+
Redis Enterprise for Kubernetes provides all the enterprise features of Redis Software:
20+
21+
- Linear scalability with Redis clustering
22+
- High availability with automatic failover
23+
- Active-Active geo-distribution
24+
- Auto Tiering for cost optimization
25+
- Enterprise-grade security and encryption
26+
- 24/7 support
27+
28+
The Redis Enterprise operator simplifies deployment and management by providing custom resource definitions (CRDs) for Redis Enterprise clusters (REC) and databases (REDB). This approach enables GitOps workflows and Kubernetes-native operations.
29+
30+
## Get started
31+
32+
Deploy Redis Enterprise on your Kubernetes cluster and create your first database.
33+
34+
- [Quick start deployment]({{< relref "/operate/kubernetes/7.22/deployment/quick-start" >}})
35+
- [Deploy with Helm]({{< relref "/operate/kubernetes/7.22/deployment/helm" >}})
36+
- [Deploy on OpenShift]({{< relref "/operate/kubernetes/7.22/deployment/openshift" >}})
37+
- [Supported Kubernetes distributions]({{< relref "/operate/kubernetes/7.22/reference/supported_k8s_distributions" >}})
38+
39+
## Redis Enterprise clusters (REC)
40+
41+
Create and manage [Redis Enterprise clusters]({{< relref "/operate/kubernetes/7.22/re-clusters" >}}) on Kubernetes.
42+
43+
- [Connect to admin console]({{< relref "/operate/kubernetes/7.22/re-clusters/connect-to-admin-console" >}})
44+
- [Auto Tiering]({{< relref "/operate/kubernetes/7.22/re-clusters/auto-tiering" >}})
45+
- [Multi-namespace deployment]({{< relref "/operate/kubernetes/7.22/re-clusters/multi-namespace" >}})
46+
- [Cluster recovery]({{< relref "/operate/kubernetes/7.22/re-clusters/cluster-recovery" >}})
47+
- [REC API reference]({{< relref "/operate/kubernetes/7.22/reference/api/redis_enterprise_cluster_api" >}})
48+
49+
## Redis Enterprise databases (REDB)
50+
51+
Create and manage [Redis Enterprise databases]({{< relref "/operate/kubernetes/7.22/re-databases" >}}) using Kubernetes resources.
52+
53+
- [Database controller]({{< relref "/operate/kubernetes/7.22/re-databases/db-controller" >}})
54+
- [Create replica databases]({{< relref "/operate/kubernetes/7.22/re-databases/replica-redb" >}})
55+
- [REDB API reference]({{< relref "/operate/kubernetes/7.22/reference/api/redis_enterprise_database_api" >}})
56+
57+
## Active-Active databases
58+
59+
Set up globally distributed [Active-Active databases]({{< relref "/operate/kubernetes/7.22/active-active" >}}) across multiple Kubernetes clusters.
60+
61+
- [Prepare participating clusters]({{< relref "/operate/kubernetes/7.22/active-active/prepare-clusters" >}})
62+
- [Create Active-Active database]({{< relref "/operate/kubernetes/7.22/active-active/create-reaadb" >}})
63+
- [Global configuration]({{< relref "/operate/kubernetes/7.22/active-active/global-config" >}})
64+
- [REAADB API reference]({{< relref "/operate/kubernetes/7.22/reference/api/redis_enterprise_active_active_database_api" >}})
65+
- [Remote cluster API reference]({{< relref "/operate/kubernetes/7.22/reference/api/redis_enterprise_remote_cluster_api" >}})
66+
67+
## Security
68+
69+
Manage [secure connections]({{< relref "/operate/kubernetes/7.22/security" >}}) and access control for your Redis Enterprise deployment.
70+
71+
- [Manage REC credentials]({{< relref "/operate/kubernetes/7.22/security/manage-rec-credentials" >}})
72+
- [Manage REC certificates]({{< relref "/operate/kubernetes/7.22/security/manage-rec-certificates" >}})
73+
- [Internode encryption]({{< relref "/operate/kubernetes/7.22/security/internode-encryption" >}})
74+
- [LDAP authentication]({{< relref "/operate/kubernetes/7.22/security/ldap" >}})
75+
76+
## Reference
77+
78+
Use the Kubernetes API and command-line tools to manage your Redis Enterprise deployment.
79+
80+
- [Redis Enterprise cluster API (REC)]({{< relref "/operate/kubernetes/7.22/reference/api/redis_enterprise_cluster_api" >}})
81+
- [Redis Enterprise database API (REDB)]({{< relref "/operate/kubernetes/7.22/reference/api/redis_enterprise_database_api" >}})
82+
- [Active-Active database API (REAADB)]({{< relref "/operate/kubernetes/7.22/reference/api/redis_enterprise_active_active_database_api" >}})
83+
- [Remote cluster API (RERC)]({{< relref "/operate/kubernetes/7.22/reference/api/redis_enterprise_remote_cluster_api" >}})
84+
85+
## Logs & monitoring
86+
87+
Monitor and troubleshoot your Redis Enterprise deployment.
88+
89+
- [Collect logs]({{< relref "/operate/kubernetes/7.22/logs/collect-logs" >}})
90+
- [Connect to Prometheus operator]({{< relref "/operate/kubernetes/7.22/re-clusters/connect-prometheus-operator" >}})
91+
92+
## Upgrade
93+
94+
Keep your Redis Enterprise deployment up to date.
95+
96+
- [Upgrade Redis cluster]({{< relref "/operate/kubernetes/7.22/upgrade/upgrade-redis-cluster" >}})
97+
- [Upgrade with OpenShift CLI]({{< relref "/operate/kubernetes/7.22/upgrade/openshift-cli" >}})
98+
- [Upgrade with OLM]({{< relref "/operate/kubernetes/7.22/upgrade/upgrade-olm" >}})
99+
100+
## Release notes
101+
102+
Stay informed about new features, enhancements, and fixes.
103+
104+
- [Release notes]({{< relref "/operate/kubernetes/release-notes" >}})
105+
106+
## Related info
107+
108+
- [Redis Enterprise Software]({{< relref "/operate/rs" >}})
109+
- [Redis Cloud]({{< relref "/operate/rc" >}})
110+
- [Redis Open Source]({{< relref "/operate/oss_and_stack" >}})
111+
- [Glossary]({{< relref "/glossary" >}})
Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
---
2+
Title: Active-Active databases
3+
alwaysopen: false
4+
categories:
5+
- docs
6+
- operate
7+
- kubernetes
8+
description: Create and manage Active-Active Redis Enterprise databases across multiple Kubernetes clusters.
9+
hideListLinks: true
10+
linkTitle: Active-Active databases
11+
weight: 40
12+
url: '/operate/kubernetes/7.22/active-active/'
13+
---
14+
15+
Redis Enterprise [Active-Active]({{< relref "/operate/rs/databases/active-active/" >}}) databases on Kubernetes provide read and write access to the same dataset from different Kubernetes clusters. This enables globally distributed applications with local read and write access, automatic conflict resolution, and seamless failover capabilities.
16+
17+
Active-Active databases use multi-master replication to keep data synchronized across participating clusters, allowing applications to read and write data locally while maintaining global consistency.
18+
19+
## Active-Active setup methods
20+
21+
There are two methods for creating an Active-Active database with Redis Enterprise for Kubernetes:
22+
23+
- The `RedisEnterpriseActiveActiveDatabase` (REAADB) custom resource is available for versions 6.4.2 and later.
24+
- The `crdb-cli` method is available for versions 6.4.2 or earlier.
25+
26+
27+
We recommend creating new Active-Active databases using the RedisEnterpriseActiveActiveDatabase (REAADB) custom resource. This allows you to manage your Active-Active database with the operator and ensures you have the latest features and functionality.
28+
29+
### Active-Active controller method
30+
31+
Versions 6.4.2-6 or later fully support the Active-Active controller. Some of these features were available as a preview in 6.4.2-4 and 6.4.2-5. Please upgrade to 6.4.2-6 for the full set of general availability features and bug fixes.
32+
33+
This setup method includes the following steps:
34+
35+
1. Gather REC credentials and [prepare participating clusters]({{< relref "/operate/kubernetes/7.22/active-active/prepare-clusters" >}}).
36+
2. Create [`RedisEnterpriseRemoteCluster` (RERC)]({{< relref "/operate/kubernetes/7.22/active-active/create-reaadb#create-rerc" >}}) resources.
37+
3. Create [`RedisEnterpriseActiveActiveDatabase` (REAADB)]({{< relref "/operate/kubernetes/7.22/active-active/create-reaadb#create-reaadb" >}}) resource.
38+
39+
### `crdb-cli` method
40+
41+
For versions 6.4.2 or earlier, this Active-Active setup method includes the following steps:
42+
43+
1. Install and configure an ingress.
44+
2. Gather configuration details.
45+
3. Add the `ActiveActive` field to the REC spec.
46+
4. Create the database with the `crdb-cli` tool.
47+
48+
## Redis Enterprise Active-Active controller for Kubernetes
49+
50+
{{<note>}}These features are supported for general availability in releases 6.4.2-6 and later.{{</note>}}
51+
52+
[Active-Active]({{< relref "/operate/rs/databases/active-active/" >}}) databases give you read-and-write access to Redis Enterprise clusters (REC) in different Kubernetes clusters or namespaces. Active-Active deployments managed by the Redis Enterprise operator require two additional custom resources: Redis Enterprise Active-Active database (REAADB) and Redis Enterprise remote cluster (RERC).
53+
54+
To create an Active-Active Redis Enterprise deployment for Kubernetes with these new features, first [prepare participating clusters]({{< relref "/operate/kubernetes/7.22/active-active/prepare-clusters" >}}) then [create an Active-Active database]({{< relref "/operate/kubernetes/7.22/active-active/create-reaadb" >}}).
55+
56+
### REAADB custom resource
57+
58+
Redis Enterprise Active-Active database (REAADB) contains a link to the RERC for each participating cluster, and provides configuration and status to the management plane.
59+
60+
For a full list of fields and options, see the [REAADB API reference]({{<relref "/operate/kubernetes/7.22/reference/api/redis_enterprise_active_active_database_api">}}).
61+
62+
For examples, see the [YAML examples]({{< relref "/operate/kubernetes/7.22/reference/yaml/active-active" >}}) section.
63+
64+
### RERC custom resource
65+
66+
Redis Enterprise remote cluster (RERC) custom resource contains configuration details for all the participating clusters.
67+
68+
For a full list of fields and options, see the [RERC API reference]({{<relref "/operate/kubernetes/7.22/reference/api/redis_enterprise_remote_cluster_api">}}).
69+
70+
For examples, see the [YAML examples]({{< relref "/operate/kubernetes/7.22/reference/yaml/active-active" >}}) section.
71+
72+
### Limitations
73+
74+
* Existing Redis databases cannot be migrated to a REAADB. (DOC-3594)
75+
* Admission is not blocking REAADB with `shardCount` which exceeds license quota. (RED-96301)
76+
Workaround: Fix the problems with the REAADB and reapply.
77+
* The `<rec-name>/<rec-namespace>` value must be unique for each RERC resource. (RED-96302)
78+
* Only global database options are supported, no support for specifying configuration per location.
79+
* No support for migration from old (`crdb-cli`) Active-Active database method to new Active-Active controller.
80+
* No support for REAADB with participating clusters co-located within the same Kubernetes cluster, except for a single designated local participating cluster.
81+
82+
## More info
83+
84+
For more general information about Active-Active, see the [Redis Enterprise Software docs]({{< relref "/operate/rs/databases/active-active/" >}}).

0 commit comments

Comments
 (0)