Skip to content

Commit 76d14cb

Browse files
author
Nikolas De Giorgis
authored
Fix broken docs link (#209)
1 parent 586c33e commit 76d14cb

File tree

6 files changed

+19
-21
lines changed

6 files changed

+19
-21
lines changed

docs/architecture.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -12,23 +12,23 @@ The MongoDB Community Kubernetes Operator is a [Custom Resource Definition](http
1212

1313
You create and update MongoDB resources by defining a MongoDB resource definition. When you apply the MongoDB resource definition to your Kubernetes environment, the Operator:
1414

15-
1. Creates a [StatefulSet](https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/) that contains one [pod](https://kubernetes.io/docs/concepts/workloads/pods/pod-overview/) for each [replica set](https://docs.mongodb.com/manual/replication/) member.
16-
1. Writes the Automation configuration as a [ConfigMap](https://kubernetes.io/docs/concepts/configuration/configmap/) and mounts it to each pod.
15+
1. Creates a [StatefulSet](https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/) that contains one [pod](https://kubernetes.io/docs/concepts/workloads/pods/pod-overview/) for each [replica set](https://docs.mongodb.com/manual/replication/) member.
16+
1. Writes the Automation configuration as a [ConfigMap](https://kubernetes.io/docs/concepts/configuration/configmap/) and mounts it to each pod.
1717
1. Creates one [init container](https://kubernetes.io/docs/concepts/workloads/pods/init-containers/) and two [containers](https://kubernetes.io/docs/concepts/containers/overview/) in each pod:
1818

1919
- An init container which copies the `cmd/versionhook` binary to the main `mongod` container. This is run before `mongod` starts to handle [version upgrades](#example-mongodb-version-upgrade).
2020

2121
- A container for the [`mongod`](https://docs.mongodb.com/manual/reference/program/mongod/index.html) process binary. `mongod` is the primary daemon process for the MongoDB system. It handles data requests, manages data access, and performs background management operations.
2222

23-
- A container for the MongoDB Agent. The Automation function of the MongoDB Agent handles configuring, stopping, and restarting the `mongod` process. The MongoDB Agent periodically polls the `mongod` to determine status and can deploy changes as needed.
24-
23+
- A container for the MongoDB Agent. The Automation function of the MongoDB Agent handles configuring, stopping, and restarting the `mongod` process. The MongoDB Agent periodically polls the `mongod` to determine status and can deploy changes as needed.
24+
2525
1. Creates several volumes:
2626

2727
- `data-volume` which is [persistent](https://kubernetes.io/docs/concepts/storage/persistent-volumes/) and mounts to `/data` on both the server and agent containers. Stores server data as well as `automation-mongod.conf` written by the agent and some locks the agent needs.
2828
- `automation-config` which is mounted from the previously generated ConfigMap to both the server and agent. Only lives as long as the pod.
2929
- `healthstatus` which contains the agent's current status. This is shared with the `mongod` container where it's used by the pre-stop hook. Only lives as long as the pod.
30-
31-
1. Initiates the MongoDB Agent, which in turn creates the database configuration and launches the `mongod` process according to your [MongoDB resource definition](deploy/crds/mongodb.com_v1_mongodb_cr.yaml).
30+
31+
1. Initiates the MongoDB Agent, which in turn creates the database configuration and launches the `mongod` process according to your [MongoDB resource definition](../deploy/crds/mongodb.com_v1_mongodb_cr.yaml).
3232

3333
<!--
3434
<img src="" alt="Architecure diagram of the MongoDB Community Kubernetes Operator">
@@ -51,7 +51,7 @@ This architecture maximizes use of the MongoDB Agent while integrating naturally
5151

5252
## Example: MongoDB Version Upgrade
5353

54-
The MongoDB Community Kubernetes Operator uses the Automation function of the MongoDB Agent to efficiently handle rolling upgrades. The Operator configures the StatefulSet to block Kubernetes from performing native rolling upgrades because the native process can trigger multiple re-elections in your MongoDB cluster.
54+
The MongoDB Community Kubernetes Operator uses the Automation function of the MongoDB Agent to efficiently handle rolling upgrades. The Operator configures the StatefulSet to block Kubernetes from performing native rolling upgrades because the native process can trigger multiple re-elections in your MongoDB cluster.
5555

5656
When you update the MongoDB version in your resource definition and reapply it to your Kubernetes environment, the Operator initiates a rolling upgrade:
5757

docs/contributing.md

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ our local working environments in CI/CD systems.
1717

1818
# High-Perspective Architecture
1919

20-
The operator itself consists of 1 image, that has all the operational logic to deploy and
20+
The operator itself consists of 1 image, that has all the operational logic to deploy and
2121
maintain the MongoDB resources in your cluster.
2222

2323
The operator deploys MongoDB in Pods (via a higher-level resource, a
@@ -64,7 +64,7 @@ of this file.
6464

6565
## Configure Docker registry
6666

67-
The build process consist in multiple Docker images being built, you need to specify
67+
The build process consist in multiple Docker images being built, you need to specify
6868
where you want the locally build images to be pushed. The Docker registry needs to be
6969
accessible from your Kubernetes cluster.
7070

@@ -128,9 +128,7 @@ MongoDB Replica Set and asserts that the deployed server can be connected to.
128128
# Writing new E2E tests
129129

130130
You can start with `replica_set` test as an starting point to write a new test.
131-
The tests are written using `operator-sdk` and so you can find more information
132-
about how to write tests in the [official operator-sdk
133-
docs](https://sdk.operatorframework.io/docs/golang/legacy/e2e-tests/).
131+
The tests are written using `operator-sdk`.
134132

135133
Adding a new test is as easy as to create a new directory in `test/e2e` with the
136134
new E2E test, and to run them:
@@ -144,11 +142,11 @@ python scripts/dev/e2e.py --test <new-test>
144142
## Set up pre-commit hooks
145143
To set up the pre-commit hooks, please create symbolic links from the provided [hooks](https://github.com/mongodb/mongodb-kubernetes-operator/tree/master/scripts/git-hooks):
146144

147-
* Navigate to your `.git/hooks` directory:
145+
* Navigate to your `.git/hooks` directory:
148146

149147
`cd .git/hooks`
150148

151-
* Create a symlink for every file in the `scripts/git-hooks` directory:
149+
* Create a symlink for every file in the `scripts/git-hooks` directory:
152150

153151
`ln -s -f ../../scripts/git-hooks/* .`
154152

docs/deploy-configure.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Deploy and Configure a MongoDB Resource #
22

3-
The [`/deploy/crds`](deploy/crds) directory contains example MongoDB resources that you can modify and deploy.
3+
The [`/deploy/crds`](../deploy/crds) directory contains example MongoDB resources that you can modify and deploy.
44

55
## Table of Contents
66

@@ -39,9 +39,9 @@ If you update `spec.version` to a later version, consider setting `spec.featureC
3939

4040
If you want to deploy the operator on OpenShift you will have to provide the environment variable `MANAGED_SECURITY_CONTEXT` set to `true` for both the mongodb and mongodb agent containers, as well as the operator deployment.
4141

42-
See [here](deploy/crds/mongodb.com_v1_mongodb_openshift_cr.yaml) for an example of how to provide the required configuration for a MongoDB ReplicaSet.
42+
See [here](../deploy/crds/mongodb.com_v1_mongodb_openshift_cr.yaml) for an example of how to provide the required configuration for a MongoDB ReplicaSet.
4343

44-
See [here](deploy/operator_openshift.yaml) for an example of how to configure the Operator deployment.
44+
See [here](../deploy/operator_openshift.yaml) for an example of how to configure the Operator deployment.
4545

4646
### Example
4747

docs/install-upgrade.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ To install the MongoDB Community Kubernetes Operator:
3232

3333
a. Invoke the following `kubectl` command:
3434
```
35-
kubectl create -f deploy/crds/mongodb.com_mongodb_crd.yaml
35+
kubectl create -f deploy/crds/mongodb.com_mongodb_scram_crd.yaml
3636
```
3737
b. Verify that the Custom Resource Definitions installed successfully:
3838
```

docs/users.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Create a Database User #
22

3-
You can create a MongoDB database user to authenticate to your MongoDB resource using [SCRAM](https://docs.mongodb.com/manual/core/security-scram/). First, [create a Kubernetes secret](#create-a-user-secret) for the new user's password. Then, [modify and apply the MongoDB resource definition](#modify-the-mongodb-crd).
3+
You can create a MongoDB database user to authenticate to your MongoDB resource using [SCRAM](https://docs.mongodb.com/manual/core/security-scram/). First, [create a Kubernetes secret](#create-a-user-secret) for the new user's password. Then, [modify and apply the MongoDB resource definition](#modify-the-mongodb-resource).
44

55
You cannot disable SCRAM authentication.
66

@@ -58,7 +58,7 @@ You cannot disable SCRAM authentication.
5858
users:
5959
- name: <username>
6060
db: <authentication-database>
61-
passwordSecretRef:
61+
passwordSecretRef:
6262
name: <db-user-secret>
6363
roles:
6464
- name: <role-1>

scripts/git-hooks/pre-commit

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,8 +41,8 @@ function go_linting() {
4141
do
4242
dirs_to_analyze+=("$(dirname "${file}")" )
4343
done
44-
mapfile -t dirs_to_analyze < <(printf '%s\n' "${dirs_to_analyze[@]}" | sort -u)
4544
if [ ${#dirs_to_analyze[@]} -ne 0 ]; then
45+
mapfile -t dirs_to_analyze < <(printf '%s\n' "${dirs_to_analyze[@]}" | sort -u)
4646
echo "Running golangci-lint on staged files"
4747
local exit_status=0
4848
for file in "${dirs_to_analyze[@]}"

0 commit comments

Comments
 (0)