Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/UnderGreen/ansible-role-mongodb

Ansible role to configure MongoDB
https://github.com/UnderGreen/ansible-role-mongodb

Last synced: about 1 month ago
JSON representation

Ansible role to configure MongoDB

Awesome Lists containing this project

README 

        
# Ansible role for MongoDB

![Centos](https://github.com/UnderGreen/ansible-role-mongodb/actions/workflows/centos.yml/badge.svg) ![Debian](https://github.com/UnderGreen/ansible-role-mongodb/actions/workflows/debian.yml/badge.svg) ![Ubuntu](https://github.com/UnderGreen/ansible-role-mongodb/actions/workflows/ubuntu.yml/badge.svg) ![Amazon Linux 2](https://github.com/UnderGreen/ansible-role-mongodb/actions/workflows/amazonlinux2.yml/badge.svg)



Ansible role to install and manage [MongoDB](http://www.mongodb.org/).



- Install and configure the MongoDB

- Configure mongodb users

- Configure authentication

- Configure replication

- Setup MMS automation agent;



MongoDB support matrix:



| Distribution   | < MongoDB 3.4 |    MongoDB 3.6     |    MongoDB 4.0     |   MongoDB 4.2      |   MongoDB 4.4      |

| -------------- | :-----------: | :----------------: | :----------------: | :----------------: | :----------------: |

| Ubuntu 16.04   |  :no_entry:   | :white_check_mark: | :white_check_mark: | :white_check_mark: |        :x:         |

| Ubuntu 18.04   |  :no_entry:   | :white_check_mark: | :white_check_mark: | :white_check_mark: |        :x:         |

| Ubuntu 20.04   |  :no_entry:   |        :x:         |        :x:         |        :x:         | :white_check_mark: |

| Debian 9.x     |  :no_entry:   | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |

| Debian 10.x    |  :no_entry:   |        :x:         |        :x:         | :white_check_mark: | :white_check_mark: |

| RHEL 7.x       |  :no_entry:   | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |

| RHEL 8.x       |  :no_entry:   | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |

| Amazon Linux 2 |  :no_entry:   | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |



- :white_check_mark: - fully tested

- :x: - don't have official support

- :no_entry: - MongoDB has reached EOL



#### Variables



```yaml

# This variable is used to set source of MongoDB installation.

# 'mongodb' - version provided by Debian-based distributions from their official package repositories.

# 'mongodb-org' - version provided by MongoDB package repository.

# 'mongodb' is not included in th role test matrix and working of it is not guarantied.

mongodb_package: mongodb-org



# `mongodb_version` variable sets version of MongoDB.

# Should be '3.6', '4.0', '4.2' or '4.4'. This role doesn't support MongoDB < 3.6.

# I would recommend you to use the latest version of MongoDB.

mongodb_version: "4.4"



mongodb_pymongo_from_pip: true # Install latest PyMongo via PIP or package manager

mongodb_pymongo_pip_version: 3.6.1 # Choose PyMong version to install from pip. If not set use latest

mongodb_user_update_password: "on_create" # MongoDB user password update default policy

mongodb_manage_service: true

mongodb_manage_systemd_unit: true



# Disable transparent hugepages on systemd debian based installations

mongodb_disable_transparent_hugepages: false



# You can enable or disable NUMA support

mongodb_use_numa: true



mongodb_user: "{{ 'mongod' if ('RedHat' == ansible_os_family) else 'mongodb' }}"

mongodb_uid:

mongodb_gid:

mongodb_daemon_name: "{{ 'mongod' if ('mongodb-org' in mongodb_package) else 'mongodb' }}"

## net Options

mongodb_net_bindip: 127.0.0.1 # Comma separated list of ip addresses to listen on

mongodb_net_http_enabled: false # Enable http interface

mongodb_net_ipv6: false # Enable IPv6 support (disabled by default)

mongodb_net_maxconns: 65536 # Max number of simultaneous connections

mongodb_net_port: 27017 # Specify port number



## processManagement Options

mongodb_processmanagement_fork: false # Fork server process



## security Options

# Disable or enable security. Possible values: 'disabled', 'enabled'

mongodb_security_authorization: "disabled"

mongodb_security_keyfile: /etc/mongodb-keyfile # Specify path to keyfile with password for inter-process authentication



## storage Options

mongodb_storage_dbpath: /data/db # Directory for datafiles

mongodb_storage_dirperdb: false # Use one directory per DB



# The storage engine for the mongod database

mongodb_storage_engine: "wiredTiger"

# mmapv1 specific options

mongodb_storage_quota_enforced: false # Limits each database to a certain number of files

mongodb_storage_quota_maxfiles: 8 # Number of quota files per DB

mongodb_storage_smallfiles: false # Very useful for non-data nodes



mongodb_storage_journal_enabled: true # Enable journaling

mongodb_storage_prealloc: true # Disable data file preallocation



# WiredTiger Options

mongodb_wiredtiger_cache_size: 1 # Cache size for wiredTiger in GB



## systemLog Options

## The destination to which MongoDB sends all log output. Specify either 'file' or 'syslog'.

## If you specify 'file', you must also specify mongodb_systemlog_path.

mongodb_systemlog_destination: "file"

mongodb_systemlog_logappend: true # Append to logpath instead of over-writing

mongodb_systemlog_path: /var/log/mongodb/{{ mongodb_daemon_name }}.log # Log file to send write to instead of stdout



## replication Options

mongodb_replication_replset: # Enable replication [/]

mongodb_replication_replindexprefetch: "all" # specify index prefetching behavior (if secondary) [none|_id_only|all]

mongodb_replication_oplogsize: 1024 # specifies a maximum size in megabytes for the replication operation log



## setParameter options

# Configure setParameter option.

# Example :

mongodb_set_parameters:

  {

    "enableLocalhostAuthBypass": "true",

    "authenticationMechanisms": "SCRAM-SHA-1,MONGODB-CR",

  }



## Extend config with arbitrary values

# Example :

mongodb_config:

  replication:

    - "enableMajorityReadConcern: false"



# MMS Agent

mongodb_mms_agent_pkg: https://cloud.mongodb.com/download/agent/monitoring/mongodb-mms-monitoring-agent_7.2.0.488-1_amd64.ubuntu1604.deb

mongodb_mms_group_id: ""

mongodb_mms_api_key: ""

mongodb_mms_base_url: https://mms.mongodb.com



# Log rotation

mongodb_logrotate: true # Rotate mongodb logs.

mongodb_logrotate_options:

  - compress

  - copytruncate

  - daily

  - dateext

  - rotate 7

  - size 10M



# password for inter-process authentication

# please regenerate this file on production environment with command 'openssl rand -base64 741'

mongodb_keyfile_content: |

  8pYcxvCqoe89kcp33KuTtKVf5MoHGEFjTnudrq5BosvWRoIxLowmdjrmUpVfAivh

  CHjqM6w0zVBytAxH1lW+7teMYe6eDn2S/O/1YlRRiW57bWU3zjliW3VdguJar5i9

  Z+1a8lI+0S9pWynbv9+Ao0aXFjSJYVxAm/w7DJbVRGcPhsPmExiSBDw8szfQ8PAU

  2hwRl7nqPZZMMR+uQThg/zV9rOzHJmkqZtsO4UJSilG9euLCYrzW2hdoPuCrEDhu

  Vsi5+nwAgYR9dP2oWkmGN1dwRe0ixSIM2UzFgpaXZaMOG6VztmFrlVXh8oFDRGM0

  cGrFHcnGF7oUGfWnI2Cekngk64dHA2qD7WxXPbQ/svn9EfTY5aPw5lXzKA87Ds8p

  KHVFUYvmA6wVsxb/riGLwc+XZlb6M9gqHn1XSpsnYRjF6UzfRcRR2WyCxLZELaqu

  iKxLKB5FYqMBH7Sqg3qBCtE53vZ7T1nefq5RFzmykviYP63Uhu/A2EQatrMnaFPl

  TTG5CaPjob45CBSyMrheYRWKqxdWN93BTgiTW7p0U6RB0/OCUbsVX6IG3I9N8Uqt

  l8Kc+7aOmtUqFkwo8w30prIOjStMrokxNsuK9KTUiPu2cj7gwYQ574vV3hQvQPAr

  hhb9ohKr0zoPQt31iTj0FDkJzPepeuzqeq8F51HB56RZKpXdRTfY8G6OaOT68cV5

  vP1O6T/okFKrl41FQ3CyYN5eRHyRTK99zTytrjoP2EbtIZ18z+bg/angRHYNzbgk

  lc3jpiGzs1ZWHD0nxOmHCMhU4usEcFbV6FlOxzlwrsEhHkeiununlCsNHatiDgzp

  ZWLnP/mXKV992/Jhu0Z577DHlh+3JIYx0PceB9yzACJ8MNARHF7QpBkhtuGMGZpF

  T+c73exupZFxItXs1Bnhe3djgE3MKKyYvxNUIbcTJoe7nhVMrwO/7lBSpVLvC4p3

  wR700U0LDaGGQpslGtiE56SemgoP



# names and passwords for administrative users

mongodb_user_admin_name: siteUserAdmin

mongodb_user_admin_password: passw0rd



mongodb_root_admin_name: siteRootAdmin

mongodb_root_admin_password: passw0rd



mongodb_root_backup_name: backupuser

mongodb_root_backup_password: passw0rd

```



#### Usage



Add `undergreen.mongodb` to your roles and set vars in your playbook file.



Example vars for authorization:



```yaml

mongodb_security_authorization: "enabled"

mongodb_users:

  - {

    name: testUser,

    password: passw0rd,

    roles: readWrite,

    database: app_development

}

```



Example vars for oplog user:



```yaml

mongodb_oplog_users:

  - {

    user: oplog,

    password: passw0rd

}

```



Required vars to change on production:



```yaml

mongodb_user_admin_password

mongodb_root_admin_password

mongodb_root_backup_password



# if you use replication and authorization

mongodb_security_keyfile

```



Example vars for replication:



```yaml

# It's a 'master' node

mongodb_login_host: 192.168.56.2



# mongodb_replication_params should be configured on each replica set node

mongodb_replication_params:

  - {

      host_name: 192.168.56.2,

      host_port: "{{ mongodb_net_port }}",

      host_type: replica,

    }

  # host_type can be replica(default) and arbiter

```



And inventory file for replica set:



```ini

[mongo_master]

192.158.56.2 mongodb_master=True # it is't a really master of MongoDB replica set,

                                 # use this variable for replica set init only

								 # or when master is moved from initial master node



[mongo_replicas]

192.168.56.3

192.168.56.4



[mongo:children]

mongo_master

mongo_replicas

```



Licensed under the GPLv2 License. See the [LICENSE.md](LICENSE.md) file for details.



#### Feedback, bug-reports, requests, ...



Are [welcome](https://github.com/UnderGreen/ansible-role-mongodb/issues)!