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 <SomePassword>
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.yamlfor wiredtiger settings and log paths -
Within
templates/mongo/statefulset.yamlthe mongod boot options can be changed to suit requirements. -
Also for some of the dynamic yaml configuration based on environment look at
environments/dev.yamlcreating 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