Fix documentation (#1325)

* Fix link to users.md * Remove Ubuntu image for agent * Fix Markdown links * Fix Markdown links * Fix secure.md * Fix secure.md * Revert "Remove Ubuntu image for agent" This reverts commit 7e55793.

Author: lucian-tosa

README.md

@@ -29,12 +29,12 @@ Here is a talk from MongoDB Live 2020 about the Community Operator:
 
 ## Documentation
 
-See the [documentation](/docs) to learn how to:
+See the [documentation](docs) to learn how to:
 
-1. [Install or upgrade](/docs/install-upgrade.md) the Operator.
-1. [Deploy and configure](/docs/deploy-configure.md) MongoDB resources.
-1. [Create a database user](/docs/users.md) with SCRAM authentication.
-1. [Secure MongoDB resource connections](/docs/secure.md) using TLS.
+1. [Install or upgrade](docs/install-upgrade.md) the Operator.
+1. [Deploy and configure](docs/deploy-configure.md) MongoDB resources.
+1. [Create a database user](docs/users.md) with SCRAM authentication.
+1. [Secure MongoDB resource connections](docs/secure.md) using TLS.
 
 *NOTE: [MongoDB Enterprise Kubernetes Operator](https://www.mongodb.com/docs/kubernetes-operator/master/) docs are for the enterprise operator use case and NOT for the community operator. In addition to the docs mentioned above, you can refer to this [blog post](https://www.mongodb.com/blog/post/run-secure-containerized-mongodb-deployments-using-the-mongo-db-community-kubernetes-oper) as well to learn more about community operator deployment*
 
@@ -61,8 +61,8 @@ The MongoDB Community Kubernetes Operator supports the following features:
 
 Before you contribute to the MongoDB Community Kubernetes Operator, please read:
 
-- [MongoDB Community Kubernetes Operator Architecture](/docs/architecture.md)
-- [Contributing to MongoDB Community Kubernetes Operator](/docs/contributing.md)
+- [MongoDB Community Kubernetes Operator Architecture](docs/architecture.md)
+- [Contributing to MongoDB Community Kubernetes Operator](docs/contributing.md)
 
 Please file issues before filing PRs. For PRs to be accepted, contributors must sign our [CLA](https://www.mongodb.com/legal/contributor-agreement).
 

docs/README.md

@@ -2,9 +2,9 @@
 
 ## Table of Contents
 
-- [Contribute to the MongoDB Kubernetes Operator](/docs/contributing.md)
-- [MongoDB Community Kubernetes Operator Architecture](/docs/architecture.md)
-- [Install and Upgrade the Community Kubernetes Operator](/docs/install-upgrade.md)
-- [Deploy and Configure MongoDBCommunity Resources](/docs/deploy-configure.md)
-- [Create Database Users](/docs/users.md)
-- [Secure MongoDBCommunity Resources](/docs/secure.md)
+- [Contribute to the MongoDB Kubernetes Operator](contributing.md)
+- [MongoDB Community Kubernetes Operator Architecture](architecture.md)
+- [Install and Upgrade the Community Kubernetes Operator](install-upgrade.md)
+- [Deploy and Configure MongoDBCommunity Resources](deploy-configure.md)
+- [Create Database Users](users.md)
+- [Secure MongoDBCommunity Resources](secure.md)

docs/build_operator_locally.md

@@ -47,7 +47,7 @@ git submodule update --init
 make all-images deploy
 ```
 
-Note: this will build and push the operator at `repo_url/mongodb-kubernetes-operator`, where `repo_url` is extracted from the [dev config file](./contributing.md#developing-locally)
+Note: this will build and push the operator at `repo_url/mongodb-kubernetes-operator`, where `repo_url` is extracted from the [dev config file](./contributing.md#developer-configuration)
 
 6. Change the `image` field in the [manager.yaml](../config/manager/manager.yaml) file to have the image you just built
 

docs/deploy-configure.md

@@ -258,7 +258,7 @@ To upgrade this resource from `4.0.6` to `4.2.7`:
 
 To deploy the operator on OpenShift you will have to provide the environment variable `MANAGED_SECURITY_CONTEXT` set to `true` for the operator deployment.
 
-See [here](/config/samples/mongodb.com_v1_mongodbcommunity_openshift_cr.yaml) for
+See [here](../config/samples/mongodb.com_v1_mongodbcommunity_openshift_cr.yaml) for
 an example of how to provide the required configuration for a MongoDB
 replica set.
 

docs/prometheus/README.md

@@ -47,7 +47,7 @@ Kubernetes Operator and resources:
 helm install community-operator mongodb/community-operator --namespace <mongodb> --create-namespace
 ```
 
-To learn more, see the [Installation Instructions](/docs/install-upgrade.md#operator-in-same-namespace-as-resources).
+To learn more, see the [Installation Instructions](../install-upgrade.md#operator-in-same-namespace-as-resources).
 
 ## Create a MongoDB Resource
 
@@ -104,7 +104,7 @@ namespace.
  a. Run the following command to create a `Secret` that 
  contains the TLS certificate `tls.crt` and `tls.key` 
  entries. You can use the certificate and key files that 
- we provide in the [`testdata/tls`](/testdata/tls) directory to create a Cert-Manager `Certificate`.
+ we provide in the [`testdata/tls`](../../testdata/tls) directory to create a Cert-Manager `Certificate`.
 
  ``` shell
  kubectl create secret tls issuer-secret --cert=../../testdata/tls/ca.crt --key=../../testdata/tls/ca.key \

docs/secure.md

@@ -15,13 +15,13 @@ certificates to encrypt traffic between:
 - Client applications and MongoDB deployments.
 
 The Operator automates TLS configuration through its integration with 
-[cert-manager](cert-manager.io), a certificate management tool for 
+[cert-manager](https://cert-manager.io/), a certificate management tool for 
 Kubernetes.
 
 ### Prerequisites
 
 Before you secure MongoDBCommunity resource connections using TLS, you 
-must [Create a database user](docs/users) to authenticate to your 
+must [Create a database user](../docs/users.md) to authenticate to your 
 MongoDBCommunity resource.
 
 ### Procedure
@@ -46,9 +46,10 @@ To secure connections to MongoDBCommunity resources with TLS using `cert-manager
 1. Create a TLS-secured MongoDBCommunity resource:
 
  ```
- helm upgrade community-operator mongodb/community-operator \
- --namespace cko-namespace --set resource.tls.useCertManager=true \
- --set createResource=true --set resource.tls.enabled=true
+ helm upgrade --install community-operator mongodb/community-operator \
+ --namespace mongodb --set resource.tls.useCertManager=true \
+ --set createResource=true --set resource.tls.enabled=true \
+ --set namespace=mongodb --create-namespace
  ```
 
  This creates a resource secured with TLS and generates the necessary