Skip to content

Commit fdc7230

Browse files
author
Kenny Scharm
authored
Update docs to use new operator name (#7)
* Update docs to use new operator name * Remove code of conduct
1 parent 65859dc commit fdc7230

File tree

10 files changed

+30
-109
lines changed

10 files changed

+30
-109
lines changed

Makefile

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ buildlinux-%: ${SOURCES}
3434
CGO_ENABLED=0 GOOS=linux go build -installsuffix cgo ${LDFLAGS} -o docker/$*/$* ./cmd/$*/main.go
3535

3636
container-%: buildlinux-%
37-
docker build -t $(PREFIX)icm-redis-$*:$(TAG) -f Dockerfile.$* .
37+
docker build -t $(PREFIX)$*-for-redis:$(TAG) -f Dockerfile.$* .
3838

3939
build: $(addprefix build-,$(CMDBINS))
4040

@@ -70,7 +70,7 @@ test:
7070
./go.test.sh
7171

7272
push-%: container-%
73-
docker push $(PREFIX)icm-redis-$*:$(TAG)
73+
docker push $(PREFIX)$*-for-redis:$(TAG)
7474

7575
push: $(addprefix push-,$(CMDBINS))
7676

charts/node-for-redis/Chart.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ name: node-for-redis
33
type: application
44
version: 0.0.0 # Overridden by release workflow
55
appVersion: 0.0.0 # Overridden by release workflow
6-
description: IBM Cluster for interfacing with Redis
6+
description: Cluster node for interfacing with Redis
77
maintainers:
88
- name: tomashibm # Tomash Sidei
99
- name: cin # Craig Ingram

charts/operator-for-redis/Chart.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ apiVersion: v2
22
name: operator-for-redis
33
type: application
44
version: 0.0.0 # Overridden by release workflow
5-
description: IBM Operator for creating and managing Redis clusters
5+
description: Operator for creating and managing Redis clusters
66
maintainers:
77
- name: tomashibm # Tomash Sidei
88
- name: cin # Craig Ingram

docs/docs/CODE_OF_CONDUCT.md

Lines changed: 0 additions & 76 deletions
This file was deleted.

docs/docs/CONTRIBUTING.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,6 @@ slug: /contributing
55

66
# Contributing
77

8-
By participating in this project, you agree to our [code of conduct](CODE_OF_CONDUCT.md).
9-
108
## Set up your machine
119

1210
Refer to our [cookbook](cookbook.md#installation) to learn how to set up your machine.

docs/docs/cookbook.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ slug: /cookbook
77

88
## Installation
99

10-
Redis operator is written in [Go](https://golang.org/).
10+
Operator for Redis Cluster is written in [Go](https://golang.org/).
1111

1212
### Required Dependencies
1313

@@ -23,7 +23,7 @@ Redis operator is written in [Go](https://golang.org/).
2323

2424
### Download and build the source code
2525

26-
Start by making a fork of the `redis-operator` repository. Then, clone your forked repo:
26+
Start by making a fork of the `operator-for-redis-cluster` repository. Then, clone your forked repo:
2727

2828
```console
2929
$ git clone [email protected]:<YOUR_USERNAME>/operator-for-redis-cluster.git
@@ -76,16 +76,16 @@ make container PREFIX= TAG=latest
7676

7777
Once the kind cluster is up and running, load the images into the kind cluster:
7878
```console
79-
$ kind load docker-image operator-for-redis-cluster:latest
80-
$ kind load docker-image icm-redis-node:latest
81-
$ kind load docker-image icm-redis-metrics:latest
79+
$ kind load docker-image operator-for-redis:latest
80+
$ kind load docker-image node-for-redis:latest
81+
$ kind load docker-image metrics-for-redis:latest
8282
```
8383

8484
### Deploy a Redis operator
8585

86-
Install the `operator-for-redis-cluster` Helm chart:
86+
Install the `operator-for-redis` Helm chart:
8787
```console
88-
$ helm install op charts/operator-for-redis-cluster --wait --set image.repository=operator-for-redis-cluster --set image.tag=latest
88+
$ helm install op charts/operator-for-redis --wait --set image.repository=operator-for-redis --set image.tag=latest
8989
NAME: op
9090
LAST DEPLOYED: Thu Oct 21 15:11:51 2021
9191
NAMESPACE: default
@@ -99,14 +99,14 @@ Confirm that the operator is running properly:
9999
```console
100100
$ kubectl get pods
101101
NAME READY STATUS RESTARTS AGE
102-
op-operator-for-redis-cluster-64dbfb4b59-xjttw 1/1 Running 0 31s
102+
op-operator-for-redis-64dbfb4b59-xjttw 1/1 Running 0 31s
103103
```
104104

105105
### Deploy a Redis cluster
106106

107107
Install the `node-for-redis` Helm chart:
108108
```console
109-
$ helm install --wait cluster charts/node-for-redis --set image.repository=icm-redis-node --set image.tag=latest
109+
$ helm install --wait cluster charts/node-for-redis --set image.repository=node-for-redis --set image.tag=latest
110110
NAME: cluster
111111
LAST DEPLOYED: Thu Oct 21 15:12:05 2021
112112
NAMESPACE: default
@@ -162,14 +162,14 @@ Note that we need both `local` and `new` image tags for a rolling update e2e tes
162162

163163
Load the required images into the kind cluster:
164164
```console
165-
$ kind load docker-image operator-for-redis-cluster:local
166-
$ kind load docker-image icm-redis-node:local
167-
$ kind load docker-image icm-redis-node:new
165+
$ kind load docker-image operator-for-redis:local
166+
$ kind load docker-image node-for-redis:local
167+
$ kind load docker-image node-for-redis:new
168168
```
169169

170-
Once the kind cluster is up and running, deploy the `operator-for-redis-cluster` Helm chart:
170+
Once the kind cluster is up and running, deploy the `operator-for-redis` Helm chart:
171171
```console
172-
$ helm install op charts/operator-for-redis-cluster --wait --set image.repository=operator-for-redis-cluster --set image.tag=local
172+
$ helm install op charts/operator-for-redis --wait --set image.repository=operator-for-redis --set image.tag=local
173173
NAME: op
174174
LAST DEPLOYED: Thu Oct 21 15:11:51 2021
175175
NAMESPACE: default
@@ -178,7 +178,7 @@ REVISION: 1
178178
TEST SUITE: None
179179
```
180180

181-
When the `operator-for-redis-cluster` pod is up and running, you can start the e2e regression:
181+
When the `operator-for-redis` pod is up and running, you can start the e2e regression:
182182
```console
183183
$ go test -timeout 30m ./test/e2e --kubeconfig=$HOME/.kube/config --ginkgo.v --test.v
184184
Running Suite: RedisCluster Suite

docs/docs/home.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@ This project contains two Helm charts, namely `operator-for-redis` and `node-for
1818

1919
![Initial state](../static/images/overview_1.png)
2020

21-
At this point, your Redis process is running and each node is aware of each other, but only one primary has all the slots. In order to properly configure each node in the cluster, we introduce the `Redis Operator`.
21+
At this point, your Redis process is running and each node is aware of each other, but only one primary has all the slots. In order to properly configure each node in the cluster, we introduce the `Operator for Redis Cluster`.
2222

23-
The `Redis Operator` watches the `RedisCluster` CR that stores cluster configuration: number of primaries, replication factor (number of replicas per primary), and the pod template. Then the operator tries to apply this configuration to the set of Redis server processes. If the number of Redis servers doesn't match the provided configuration, the manager scales the number of pods to obtain the proper number of Redis nodes. The operator continuously reconciles the state of the cluster with the configuration stored in the `RedisCluster` CR until they match. To understand how the reconciliation loop works, see the [Operator SDK docs](https://sdk.operatorframework.io/docs/building-operators/golang/tutorial/#reconcile-loop).
23+
The operator watches the `RedisCluster` CR that stores cluster configuration: number of primaries, replication factor (number of replicas per primary), and the pod template. Then the operator tries to apply this configuration to the set of Redis server processes. If the number of Redis servers doesn't match the provided configuration, the manager scales the number of pods to obtain the proper number of Redis nodes. The operator continuously reconciles the state of the cluster with the configuration stored in the `RedisCluster` CR until they match. To understand how the reconciliation loop works, see the [Operator SDK docs](https://sdk.operatorframework.io/docs/building-operators/golang/tutorial/#reconcile-loop).
2424

2525
## Deployment
2626

@@ -44,16 +44,16 @@ You can find two Helm charts in the `charts` folder:
4444

4545
Operator deployment example:
4646
```console
47-
helm install operator-for-redis-cluster charts/operator-for-redis-cluster
48-
NAME: operator-for-redis-cluster
47+
helm install operator-for-redis charts/operator-for-redis
48+
NAME: operator-for-redis
4949
LAST DEPLOYED: Fri Aug 13 11:48:29 2021
5050
NAMESPACE: default
5151
STATUS: deployed
5252

5353
RESOURCES:
5454
==> v1/Deployment
5555
NAME DESIRED CURRENT UP-TO-DATE AVAILABLE AGE
56-
operator-for-redis-cluster 1 1 1 1 10s
56+
operator-for-redis 1 1 1 1 10s
5757
```
5858

5959
#### Create the RedisCluster

docs/docusaurus.config.js

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ const isCI = !!process.env.CI;
22

33
/** @type {import('@docusaurus/types').DocusaurusConfig} */
44
module.exports = {
5-
title: 'IBM Operator for Redis Cluster',
5+
title: 'Operator for Redis Cluster',
66
url: isCI ? 'https://ibm.github.io' : 'http://localhost:3001',
77
baseUrl: '/operator-for-redis-cluster/',
88
onBrokenLinks: 'throw',
@@ -38,7 +38,7 @@ module.exports = {
3838
footer: {
3939
style: 'dark',
4040
links: [],
41-
copyright: `IBM Operator for Redis Cluster Documentation. Built with Docusaurus.`,
41+
copyright: `Operator for Redis Cluster Documentation. Built with Docusaurus.`,
4242
},
4343
},
4444
presets: [

docs/sidebars.js

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,5 @@ module.exports = {
1919
'rolling-update',
2020
'key-migration',
2121
'CONTRIBUTING',
22-
'CODE_OF_CONDUCT',
2322
],
2423
};

helm-releases/index.yaml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ entries:
44
- apiVersion: v2
55
appVersion: 6.2.6
66
created: "2022-01-06T22:09:58.04939947Z"
7-
description: IBM Cluster for interfacing with Redis
7+
description: Cluster node for interfacing with Redis
88
digest: 449a7fbe5164d6dca34426837f578420d7fa56280fc61b574fbd1f094cd99f8c
99
maintainers:
1010
- name: tomashibm
@@ -19,7 +19,7 @@ entries:
1919
- apiVersion: v2
2020
appVersion: 6.2.6
2121
created: "2022-01-06T22:09:58.048123653Z"
22-
description: IBM Cluster for interfacing with Redis
22+
description: Cluster node for interfacing with Redis
2323
digest: cee77ec7fdb4276d24a02c62f672c0769fc153ebfd69d944a40930b04a5794c7
2424
maintainers:
2525
- name: tomashibm
@@ -34,7 +34,7 @@ entries:
3434
operator-for-redis:
3535
- apiVersion: v2
3636
created: "2022-01-06T22:09:58.056363963Z"
37-
description: IBM Operator for creating and managing Redis clusters
37+
description: Operator for creating and managing Redis clusters
3838
digest: 2bc14cd0b4ed461de70c9a55fc684b9c9d863f1ed05402427321f26d51febce6
3939
maintainers:
4040
- name: tomashibm
@@ -48,7 +48,7 @@ entries:
4848
version: 0.3.6
4949
- apiVersion: v2
5050
created: "2022-01-06T22:09:58.053555926Z"
51-
description: IBM Operator for creating and managing Redis clusters
51+
description: Operator for creating and managing Redis clusters
5252
digest: f1eb5062bb0399d35efa12bea03a4464387846795fd918915d9c55197961e21c
5353
maintainers:
5454
- name: tomashibm

0 commit comments

Comments
 (0)