Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alexsjones/kubernetes-mongodb-cluster
kubernetes mongodb statefulset that scales with ssl
https://github.com/alexsjones/kubernetes-mongodb-cluster
database kubernetes manifest mongodb nosql scaling ssl statefulset
Last synced: about 2 months ago
JSON representation
kubernetes mongodb statefulset that scales with ssl
- Host: GitHub
- URL: https://github.com/alexsjones/kubernetes-mongodb-cluster
- Owner: AlexsJones
- License: gpl-3.0
- Created: 2018-10-29T17:54:07.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2019-08-02T08:24:04.000Z (over 5 years ago)
- Last Synced: 2024-12-16T00:51:48.766Z (2 months ago)
- Topics: database, kubernetes, manifest, mongodb, nosql, scaling, ssl, statefulset
- Language: Shell
- Size: 54.7 KB
- Stars: 8
- Watchers: 2
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# kubernetes-mongodb-cluster
A scalable kubernetes cluster for SSL secured mongodb.
*Updated to support 3.6/4.0 with a better sidecar implementation*
Built on the great work of others, brought together in k8s manifests.
- Statefulset
- Configmap for mongo.conf, boot options and per env tuning
- Service discovery with sidecars
- Supports auto scaling
- Example built with generated SSL cert
Influenced and inspired by:
- https://github.com/MichaelScript/kubernetes-mongodb
- https://github.com/cvallance/mongo-k8s-sidecar
- My own experience with trying to implement this.. https://kubernetes.io/blog/2017/01/running-mongodb-on-kubernetes-with-statefulsets/
## Dependencies
```
- google cloud platform (for a few annotations e.g. load balancer and pvc)
```
## Get me started
```
kubectl create ns mongodb
docker run -v $PWD:/tmp tibbar/vortex:v1 -template /tmp/templates -output /tmp/deployment -varpath /tmp/environments/dev.yaml
./generate_pem.sh
kubectl apply -f deployment/mongo
```
## Test it works
The mongo-job runs the following command
```
kubectl exec -it mongod-0 -n mongodb -c mongod -- mongo --host 127.0.0.1:27017 --authenticationDatabase admin --username root --password root --eval "rs.status()"
```
## Configuration
- Primary mongodb configuration is within `templates/mongo/configmap.yaml` for wiredtiger settings and log paths
- Within `templates/mongo/statefulset.yaml` the mongod boot options can be changed to suit requirements.
- Also for some of the dynamic yaml configuration based on environment look at `environments/dev.yaml` creating your own where applicable.
### Changing User/password
```
mongodb:
rootusername: "root"
rootpassword: "root"
```
Can be changed in the environment folder file
### Restoring a database backup
Since 1.10 you can now upload mongodumps into configmaps or in `utils/pod-mongorestore.yaml` you can just use `kubectl cp`
then execute the backup file
## Using UI tools
Tools such as mongochef/robochef can be used with their direct connection mode on localhost:27017 and
`kubectl port-forward mongod-0 27017:27017`