mongo
OSM: MONGODB
MongoDB ansible role for Standalone , Cluster(Replication) setup with Authentication
Version History
| Date | Version | Description | Changed By |
|---|---|---|---|
| 27 June 2020 | v0.0.1 | Initial draft | Rajat Vats |
| 21 March 2022 | v0.0.2 | Manage node DNS | Kritarth Pant |
PREREQUISITE
NOTHING !!!!
OS-SUPPORTED
Ubuntu 18
Centos 7
Amazon Linux 2
FEATURES
- Setup Standalone MongoDB instance
- Setup Replication over mongodb cluster
- Setup Authentication with root,admin and backup users.
IMPORTANT ROLE VARIABLES
| Variable | Default Value | Possible Values | Description |
|---|---|---|---|
| mongo_version | 4.2 | [4.2, 4.0, 3.6, 3.4] Can mention minor version as well eg: 4.2.7 | MongoDB version |
| mongo_port | 27017 | As per your requirement | MongoDB port |
| replication_enabled | false | [true, false] | Set True to setup replication |
| mongo_replSetName | repl | As per your requirement | Name of the replica set |
| authentication_enabled | true | [true, false] | If set true, role will enable authetication with predefined uses -> root , admin and backup user |
| mongo_user_admin_name | useradmin | Override default values with your ones | mongo admin user name |
| mongo_user_admin_pwd | passw0rd | Override default values with your ones | mongo admin user password |
| mongo_root_admin_name | RootAdmin | Override default values with your ones | mongo root user name |
| mongo_root_admin_pwd | passw0rd | Override default values with your ones | mongo root user password |
| mongo_root_backup_name | backupuser | Override default values with your ones | mongo backup user name |
| mongo_root_backup_pwd | passw0rd | Override default values with your ones | mongo backup user password |
| mongo_custom_users | None | Can specify multiple users with roles. Please refer below example for the reference | |
| mongo_authentication_key | Mention your key here. (GPG key) | Authentication key for cluster nodes to communicate with each other securely. |
Define Multiple users to add in MongoDB
mongo_custom_users:
- { name: user1 , password: userpwd, roles: admin }
- { name: user2 , password: userpwd, roles: backup,clusterMonitor }
INVENTORY
An example inventory could be like this:-
[mongo_master]
prim ansible_ssh_host=3.1.x.x
[mongo_slave]
sec1 ansible_ssh_host=18.141.x.x
sec2 ansible_ssh_host=54.169.x.x
[mongo:children]
mongo_master
mongo_slave
[mongo:vars]
ansible_user=ubuntu
PLAYBOOK EXAMPLE
Here is an example of playbook to execute this role:-
---
- hosts: mongo
roles:
- osm_mongo
become: true
any_errors_fatal: true
USAGE
ansible-playbook -i hosts site.yml