You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/operate/kubernetes/deployment/quick-start.md
+25-23Lines changed: 25 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,7 +19,6 @@ To deploy Redis Enterprise Software for Kubernetes and start your Redis Enterpri
19
19
20
20
This guide works with most supported Kubernetes distributions. If you're using OpenShift, see [Redis Enterprise on OpenShift]({{< relref "/operate/kubernetes/deployment/openshift" >}}). For details on what is currently supported, see [supported distributions]({{< relref "/operate/kubernetes/reference/supported_k8s_distributions.md" >}}).
21
21
22
-
23
22
## Prerequisites
24
23
25
24
To deploy Redis Enterprise for Kubernetes, you'll need:
@@ -37,15 +36,15 @@ Throughout this guide, each command is applied to the namespace in which the Red
37
36
38
37
1. Create a new namespace
39
38
40
-
```sh
41
-
kubectl create namespace <rec-namespace>
42
-
```
39
+
```sh
40
+
kubectl create namespace <rec-namespace>
41
+
```
43
42
44
-
2. Change the namespace context to make the newly created namespace default for future commands.
43
+
1. Change the namespace context to make the newly created namespace default for future commands.
You can use an existing namespace as long as it does not contain any existing Redis Enterprise cluster resources. It's best practice to create a new namespace to make sure there are no Redis Enterprise resources that could interfere with the deployment.
51
50
@@ -115,7 +114,10 @@ that contains cluster specifications.
115
114
The following example creates a minimal Redis Enterprise cluster. See the [RedisEnterpriseCluster API reference]({{<relref "/operate/kubernetes/reference/redis_enterprise_cluster_api">}}) for more information on the various options available.
116
115
117
116
1. Create a file that defines a Redis Enterprise cluster with three nodes.
118
-
{{<note>}} The REC name (`my-rec` in this example) cannot be changed after cluster creation.{{</note>}}
117
+
118
+
{{<note>}}
119
+
The REC name (`my-rec` in this example) cannot be changed after cluster creation.
120
+
{{</note>}}
119
121
120
122
```sh
121
123
cat <<EOF > my-rec.yaml
@@ -152,28 +154,28 @@ The following example creates a minimal Redis Enterprise cluster. See the [Redis
152
154
153
155
1. Apply your custom resource file in the same namespace as `my-rec.yaml`.
154
156
155
-
```sh
156
-
kubectl apply -f my-rec.yaml
157
-
```
157
+
```sh
158
+
kubectl apply -f my-rec.yaml
159
+
```
158
160
159
-
You should see a result similar to this:
161
+
You should see a result similar to this:
160
162
161
-
```sh
162
-
redisenterprisecluster.app.redislabs.com/my-rec created
163
-
```
163
+
```sh
164
+
redisenterprisecluster.app.redislabs.com/my-rec created
165
+
```
164
166
165
167
1. You can verify the creation of the cluster with:
166
168
167
-
```sh
168
-
kubectl get rec
169
-
```
169
+
```sh
170
+
kubectl get rec
171
+
```
170
172
171
173
You should see a result similar to this:
172
174
173
-
```sh
174
-
NAME AGE
175
-
my-rec 1m
176
-
```
175
+
```sh
176
+
NAME AGE
177
+
my-rec 1m
178
+
```
177
179
178
180
At this point, the operator will go through the process of creating various
1. Check [Supported Kubernetes distributions]({{< relref "/operate/kubernetes/reference/supported_k8s_distributions" >}}) to make sure your Kubernetes distribution is supported.
23
23
24
-
2. Use `kubectl get rec` and verify the `LICENSE STATE` is valid on your REC before you start the upgrade process.
24
+
1. Use `kubectl get rec` and verify the `LICENSE STATE` is valid on your REC before you start the upgrade process.
25
25
26
-
3. Verify you are upgrading from Redis Enterprise operator version 6.2.10-45 or later. If you are not, you must upgrade to 6.2.10-45 before upgrading to versions 6.2.18 or later.
26
+
1. Verify you are upgrading from Redis Enterprise operator version 6.2.10-45 or later. If you are not, you must upgrade to 6.2.10-45 before upgrading to versions 6.2.18 or later.
27
27
28
28
{{<warning>}}**Upgrade cluster operating system** If your databases use modules, you need to update all nodes in the cluster to Redis Enterprise 7.2.4 or later before upgrading your operating system. See [Upgrade a cluster's operating system]({{< relref "/operate/rs/installing-upgrading/upgrading/upgrade-os" >}})in the Redis Enterprise Software documentation for more details.{{</warning>}}
We recommend upgrading the REC as soon as possible after updating the operator. After the operator upgrade completes, the operator suspends the management of the REC and its associated REDBs, until the REC upgrade completes.
100
-
{{< /warning >}}
99
+
We recommend upgrading the REC as soon as possible after updating the operator. After the operator upgrade completes, the operator suspends the management of the REC and its associated REDBs, until the REC upgrade completes.
100
+
{{< /warning >}}
101
101
102
102
## Upgrade the Redis Enterprise cluster (REC)
103
103
@@ -115,8 +115,9 @@ After the operator upgrade is complete, you can upgrade Redis Enterprise cluster
115
115
116
116
### Upgrade an REC with an Active-Active database
117
117
118
-
- We recommend upgrading all participating clusters to the same operator version.
119
-
- If you are upgrading from a preview version of the Active-Active controller, you can remove the following environment variables: `ACTIVE_ACTIVE_DATABASE_CONTROLLER_ENABLED`, `REMOTE_CLUSTER_CONTROLLER_ENABLED`, and `ENABLE_ALPHA_FEATURES`.
118
+
We recommend upgrading all participating clusters to the same operator version.
119
+
120
+
If you are upgrading from a preview version of the Active-Active controller, you can remove the following environment variables: `ACTIVE_ACTIVE_DATABASE_CONTROLLER_ENABLED`, `REMOTE_CLUSTER_CONTROLLER_ENABLED`, and `ENABLE_ALPHA_FEATURES`.
120
121
121
122
### Edit `redisEnterpriseImageSpec` in the REC spec
122
123
@@ -171,4 +172,3 @@ For more details on how to [upgrade a database]({{< relref "/operate/rs/installi
171
172
For Active-Active databases, see [Upgrade an Active-Active database]({{<relref "/operate/rs/installing-upgrading/upgrading/upgrade-active-active">}}).
172
173
173
174
Note that if your cluster [`redisUpgradePolicy`]({{< relref "/operate/kubernetes/reference/redis_enterprise_cluster_api#redisupgradepolicy" >}}) or your database [`redisVersion`]({{< relref "/operate/kubernetes/reference/redis_enterprise_database_api#redisversion" >}}) are set to `major`, you won't be able to upgrade those databases to minor versions. See [Redis upgrade policy]({{< relref "/operate/rs/installing-upgrading/upgrading#redis-upgrade-policy">}}) for more details.
0 commit comments