Skip to content

Commit

Permalink
[Development][Update] Updated documentation for v0.7.0 (#129)
Browse files Browse the repository at this point in the history
* Updated documentation with some latest content

Signed-off-by: iamabhishek-dubey <abhishekbhardwaj510@gmail.com>
  • Loading branch information
iamabhishek-dubey authored Aug 12, 2021
1 parent e0cafb7 commit ae020a6
Show file tree
Hide file tree
Showing 11 changed files with 98 additions and 20 deletions.
16 changes: 16 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,19 @@
### v0.7.0
##### August 12, 2021

#### :tada: Features

- Remove all the vulnerable dependencies from docs(NodeJS)
- Added a new grafana dashboard for better monitoring visualization
- Added environment variable support for redis exporter
- Added Image Pull Secret support for private registeries

#### :beetle: Bug Fixes

- Fix bug for non-defined storage
- Fixed secret nil exception bug
- Fixed bug for making redis exporter optional

### v0.6.0
##### June 11, 2021

Expand Down
6 changes: 4 additions & 2 deletions SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,10 @@ currently being supported with security updates.

| Version | Supported |
| ------- | ------------------ |
| 0.5.0 | :white_check_mark: |
| 0.4.0 | :white_check_mark: |
| 0.7.0 | :white_check_mark: |
| 0.6.0 | :white_check_mark: |
| 0.5.0 | :x: |
| 0.4.0 | :x: |
| 0.3.0 | :x: |
| 0.2.0 | :x: |
| 0.1.0 | :x: |
Expand Down
16 changes: 16 additions & 0 deletions docs/src/guide/changelog.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,19 @@
### v0.7.0
**August 12, 2021**

**:tada: Features**

- Remove all the vulnerable dependencies from docs(NodeJS)
- Added a new grafana dashboard for better monitoring visualization
- Added environment variable support for redis exporter
- Added Image Pull Secret support for private registeries

**:beetle: Bug Fixes**

- Fix bug for non-defined storage
- Fixed secret nil exception bug
- Fixed bug for making redis exporter optional

### v0.6.0
**June 12, 2021**

Expand Down
6 changes: 2 additions & 4 deletions docs/src/guide/grafana.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,8 @@
# Grafana Dashboard

Grafana Dashboards can be downloaded from grafana site itself by using code or by downloading dashboard JSON.
We have created a custom detailed dashboard for monitoring the stats of Redis Cluster.

**Note:- Soon we will create our own custom dashboards for redis exporter in grafana**

- [Redis Dashboard for Prometheus](https://grafana.com/grafana/dashboards/763)
- [Redis Operator Cluster Dashboard for Prometheus](https://github.com/OT-CONTAINER-KIT/redis-operator/blob/master/dashboards/redis-operator-cluster.json)

![](./images/grafana1.png)

Expand Down
Binary file modified docs/src/guide/images/grafana1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/src/guide/images/grafana2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions docs/src/guide/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ If you are beginner to Kubernetes and don't want to go inside the complexities o

```shell
$ kubectl apply -f https://raw.githubusercontent.com/OT-CONTAINER-KIT/redis-operator/master/config/crd/bases/redis.redis.opstreelabs.in_redis.yaml
$ kubectl apply -f https://raw.githubusercontent.com/OT-CONTAINER-KIT/redis-operator/master/config/crd/bases/redis.redis.opstreelabs.in_redisclusters.yaml
$ kubectl apply -f https://raw.githubusercontent.com/OT-CONTAINER-KIT/redis-operator/master/config/rbac/serviceaccount.yaml
$ kubectl apply -f https://raw.githubusercontent.com/OT-CONTAINER-KIT/redis-operator/master/config/rbac/role.yaml
$ kubectl apply -f https://raw.githubusercontent.com/OT-CONTAINER-KIT/redis-operator/master/config/rbac/role_binding.yaml
Expand Down
26 changes: 21 additions & 5 deletions docs/src/guide/monitoring.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,41 +16,57 @@ redisExporter:
limits:
cpu: 100m
memory: 128Mi
env:
- name: REDIS_EXPORTER_INCL_SYSTEM_METRICS
value: "true"
- name: UI_PROPERTIES_FILE_NAME
valueFrom:
configMapKeyRef:
name: game-demo
key: ui_properties_file_name
- name: SECRET_USERNAME
valueFrom:
secretKeyRef:
name: mysecret
key: username
```
Once the exporter is configured, we may have to update Prometheus to monitor this endpoint. For [Prometheus Operator](https://github.com/prometheus-operator/prometheus-operator), we have to create a CRD based object called **ServiceMonitor**.
### Redis Cluster
```yaml
---
apiVersion: monitoring.coreos.com/v1
kind: ServiceMonitor
metadata:
name: redis-monitoring-leader
name: redis-monitoring-cluster
labels:
redis-operator: "true"
env: production
spec:
selector:
matchLabels:
role: leader
redis_setup_type: cluster
endpoints:
- port: redis-exporter
```
### Redis Standalone
```yaml
---
apiVersion: monitoring.coreos.com/v1
kind: ServiceMonitor
metadata:
name: redis-monitoring-follower
name: redis-monitoring-standalone
labels:
redis-operator: "true"
env: production
spec:
selector:
matchLabels:
role: follower
redis_setup_type: standalone
endpoints:
- port: redis-exporter
```
15 changes: 15 additions & 0 deletions docs/src/guide/redis-cluster-config.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,6 +82,8 @@ In the `kubernetesConfig` section, we define configuration related to Kubernetes
name: redis-secret
key: password
serviceType: LoadBalancer
imagePullSecrets:
- name: regcred
```


Expand All @@ -101,6 +103,19 @@ In the `kubernetesConfig` section, we define configuration related to Kubernetes
limits:
cpu: 100m
memory: 128Mi
env:
- name: REDIS_EXPORTER_INCL_SYSTEM_METRICS
value: "true"
- name: UI_PROPERTIES_FILE_NAME
valueFrom:
configMapKeyRef:
name: game-demo
key: ui_properties_file_name
- name: SECRET_USERNAME
valueFrom:
secretKeyRef:
name: mysecret
key: username
```

**storage**
Expand Down
16 changes: 15 additions & 1 deletion docs/src/guide/redis-config.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,8 @@ In the `kubernetesConfig` section, we define configuration related to Kubernetes
name: redis-secret
key: password
serviceType: LoadBalancer
imagePullSecrets:
- name: regcred
```
Expand All @@ -73,6 +75,19 @@ In the `kubernetesConfig` section, we define configuration related to Kubernetes
limits:
cpu: 100m
memory: 128Mi
env:
- name: REDIS_EXPORTER_INCL_SYSTEM_METRICS
value: "true"
- name: UI_PROPERTIES_FILE_NAME
valueFrom:
configMapKeyRef:
name: game-demo
key: ui_properties_file_name
- name: SECRET_USERNAME
valueFrom:
secretKeyRef:
name: mysecret
key: username
```

**storage**
Expand Down Expand Up @@ -143,4 +158,3 @@ Tolerations for nodes and pods in Kubernetes.
value: "value1"
effect: "NoSchedule"
```

16 changes: 8 additions & 8 deletions docs/src/guide/setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,14 +72,14 @@ Verify the cluster by checking the pod status of leader and follower pods.
```shell
$ kubectl get pods -n ot-operators
...
NAME READY STATUS RESTARTS AGE
redis-operator-74b6cbf5c5-td8t7 1/1 Running 1 90m
redis-follower-0 2/2 Running 0 75s
redis-leader-0 2/2 Running 0 76s
redis-follower-1 2/2 Running 0 54s
redis-leader-1 2/2 Running 0 49s
redis-follower-2 2/2 Running 0 35s
redis-leader-2 2/2 Running 0 26s
NAME READY STATUS RESTARTS AGE
redis-cluster-follower-0 1/1 Running 0 149m
redis-cluster-follower-1 1/1 Running 0 150m
redis-cluster-follower-2 1/1 Running 0 151m
redis-cluster-leader-0 1/1 Running 0 149m
redis-cluster-leader-1 1/1 Running 0 150m
redis-cluster-leader-2 1/1 Running 0 151m
redis-operator-5944ffd957-pt57s 1/1 Running 0 156m
```

If all the pods are in the running state of leader and follower Statefulsets, then we can check the health of the redis cluster by using `redis-cli`.
Expand Down

0 comments on commit ae020a6

Please sign in to comment.