Merge pull request #159 from thiagoalmeidasa/master

Adding amazonlinux support
This commit is contained in:
Sergei Antipov 2019-05-21 14:14:52 -04:00 committed by GitHub
commit 3cfe431492
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
7 changed files with 159 additions and 60 deletions

View File

@ -1,6 +1,5 @@
# .travis.yml # .travis.yml
--- ---
dist: trusty dist: trusty
sudo: required sudo: required
language: python language: python
@ -86,6 +85,18 @@ env:
DISTRIBUTION=centos DISTRIBUTION=centos
DIST_VERSION=7-builded DIST_VERSION=7-builded
MONGODB_VERSION=3.4 MONGODB_VERSION=3.4
- >
DISTRIBUTION=amazonlinux
DIST_VERSION=2-builded
MONGODB_VERSION=4.0
- >
DISTRIBUTION=amazonlinux
DIST_VERSION=2-builded
MONGODB_VERSION=3.6
- >
DISTRIBUTION=amazonlinux
DIST_VERSION=2-builded
MONGODB_VERSION=3.4
services: services:
- docker - docker

102
README.md
View File

@ -1,24 +1,25 @@
Ansible role for MongoDB [![Build Status](https://travis-ci.org/UnderGreen/ansible-role-mongodb.svg?branch=master)](https://travis-ci.org/UnderGreen/ansible-role-mongodb) # Ansible role for MongoDB [![Build Status](https://travis-ci.org/UnderGreen/ansible-role-mongodb.svg?branch=master)](https://travis-ci.org/UnderGreen/ansible-role-mongodb)
============
Ansible role which manages [MongoDB](http://www.mongodb.org/). Ansible role which manages [MongoDB](http://www.mongodb.org/).
* Install and configure the MongoDB; - Install and configure the MongoDB;
* Configure mongodb users - Configure mongodb users
* Configure replication - Configure replication
* Provide handlers for restart and reload; - Provide handlers for restart and reload;
* Setup MMS authomation agent; - Setup MMS authomation agent;
MongoDB support matrix: MongoDB support matrix:
| Distribution | < MongoDB 3.0 | MongoDB 3.2 | MongoDB 3.4 | MongoDB 3.6 | MongoDB 4.0 | | Distribution | < MongoDB 3.2 | MongoDB 3.4 | MongoDB 3.6 | MongoDB 4.0 |
| ------------ |:-------------:|:-----------:|:-----------:|:-----------:|:-----------:| | -------------- | :-----------: | :----------------: | :----------------: | :----------------: |
| Ubuntu 14.04 | :no_entry: | :no_entry:| :white_check_mark:| :white_check_mark:| :white_check_mark:| | Ubuntu 14.04 | :no_entry: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| Ubuntu 16.04 | :no_entry: | :no_entry:| :white_check_mark:| :white_check_mark:| :white_check_mark:| | Ubuntu 16.04 | :no_entry: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| Ubuntu 18.04 | :no_entry: | :no_entry:| :x:| :white_check_mark:| :white_check_mark:| | Ubuntu 18.04 | :no_entry: | :x: | :white_check_mark: | :white_check_mark: |
| Debian 8.x | :no_entry: | :no_entry:| :white_check_mark:| :white_check_mark:| :white_check_mark:| | Debian 8.x | :no_entry: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| Debian 9.x | :no_entry: | :no_entry:| :x:| :white_check_mark:| :white_check_mark:| | Debian 9.x | :no_entry: | :x: | :white_check_mark: | :white_check_mark: |
| RHEL 6.x | :no_entry: | :no_entry: | :white_check_mark: | :white_check_mark:| :white_check_mark:| | RHEL 6.x | :no_entry: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| RHEL 7.x | :no_entry: | :no_entry: | :white_check_mark: | :white_check_mark:| :white_check_mark:| | RHEL 7.x | :no_entry: | :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: - fully tested, should works fine - :white_check_mark: - fully tested, should works fine
- :interrobang: - maybe works, not tested - :interrobang: - maybe works, not tested
@ -38,9 +39,9 @@ mongodb_package: mongodb-org
# I will recommend you to use latest version of MongoDB. # I will recommend you to use latest version of MongoDB.
mongodb_version: "3.6" mongodb_version: "3.6"
mongodb_pymongo_from_pip: true # Install latest PyMongo via PIP or package manager 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_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_user_update_password: "on_create" # MongoDB user password update default policy
mongodb_manage_service: true mongodb_manage_service: true
# Disable transparent hugepages on systemd debian based installations # Disable transparent hugepages on systemd debian based installations
@ -51,54 +52,58 @@ mongodb_uid:
mongodb_gid: mongodb_gid:
mongodb_daemon_name: "{{ 'mongod' if ('mongodb-org' in mongodb_package) else 'mongodb' }}" mongodb_daemon_name: "{{ 'mongod' if ('mongodb-org' in mongodb_package) else 'mongodb' }}"
## net Options ## net Options
mongodb_net_bindip: 127.0.0.1 # Comma separated list of ip addresses to listen on 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_http_enabled: false # Enable http interface
mongodb_net_ipv6: false # Enable IPv6 support (disabled by default) mongodb_net_ipv6: false # Enable IPv6 support (disabled by default)
mongodb_net_maxconns: 65536 # Max number of simultaneous connections mongodb_net_maxconns: 65536 # Max number of simultaneous connections
mongodb_net_port: 27017 # Specify port number mongodb_net_port: 27017 # Specify port number
## processManagement Options ## processManagement Options
mongodb_processmanagement_fork: false # Fork server process mongodb_processmanagement_fork: false # Fork server process
## security Options ## security Options
# Disable or enable security. Possible values: 'disabled', 'enabled' # Disable or enable security. Possible values: 'disabled', 'enabled'
mongodb_security_authorization: "disabled" mongodb_security_authorization: "disabled"
mongodb_security_keyfile: /etc/mongodb-keyfile # Specify path to keyfile with password for inter-process authentication mongodb_security_keyfile: /etc/mongodb-keyfile # Specify path to keyfile with password for inter-process authentication
## storage Options ## storage Options
mongodb_storage_dbpath: /data/db # Directory for datafiles mongodb_storage_dbpath: /data/db # Directory for datafiles
mongodb_storage_dirperdb: false # Use one directory per DB mongodb_storage_dirperdb: false # Use one directory per DB
# The storage engine for the mongod database. Available values: # The storage engine for the mongod database. Available values:
# 'mmapv1', 'wiredTiger' # 'mmapv1', 'wiredTiger'
mongodb_storage_engine: "{{ 'mmapv1' if mongodb_version[0:3] == '3.0' else 'wiredTiger' }}" mongodb_storage_engine: "{{ 'mmapv1' if mongodb_version[0:3] == '3.0' else 'wiredTiger' }}"
# mmapv1 specific options # mmapv1 specific options
mongodb_storage_quota_enforced: false # Limits each database to a certain number of files 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_quota_maxfiles: 8 # Number of quota files per DB
mongodb_storage_smallfiles: false # Very useful for non-data nodes mongodb_storage_smallfiles: false # Very useful for non-data nodes
mongodb_storage_journal_enabled: true # Enable journaling mongodb_storage_journal_enabled: true # Enable journaling
mongodb_storage_prealloc: true # Disable data file preallocation mongodb_storage_prealloc: true # Disable data file preallocation
# WiredTiger Options # WiredTiger Options
mongodb_wiredtiger_cache_size: 1 # Cache size for wiredTiger in GB mongodb_wiredtiger_cache_size: 1 # Cache size for wiredTiger in GB
## systemLog Options ## systemLog Options
## The destination to which MongoDB sends all log output. Specify either 'file' or 'syslog'. ## 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. ## If you specify 'file', you must also specify mongodb_systemlog_path.
mongodb_systemlog_destination: "file" mongodb_systemlog_destination: "file"
mongodb_systemlog_logappend: true # Append to logpath instead of over-writing 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 mongodb_systemlog_path: /var/log/mongodb/{{ mongodb_daemon_name }}.log # Log file to send write to instead of stdout
## replication Options ## replication Options
mongodb_replication_replset: # Enable replication <setname>[/<optionalseedhostlist>] mongodb_replication_replset: # Enable replication <setname>[/<optionalseedhostlist>]
mongodb_replication_replindexprefetch: "all" # specify index prefetching behavior (if secondary) [none|_id_only|all] 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 mongodb_replication_oplogsize: 1024 # specifies a maximum size in megabytes for the replication operation log
## setParameter options ## setParameter options
# Configure setParameter option. # Configure setParameter option.
# Example : # Example :
mongodb_set_parameters: { "enableLocalhostAuthBypass": "true", "authenticationMechanisms": "SCRAM-SHA-1,MONGODB-CR" } mongodb_set_parameters:
{
"enableLocalhostAuthBypass": "true",
"authenticationMechanisms": "SCRAM-SHA-1,MONGODB-CR",
}
# MMS Agent # 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_agent_pkg: https://cloud.mongodb.com/download/agent/monitoring/mongodb-mms-monitoring-agent_7.2.0.488-1_amd64.ubuntu1604.deb
@ -107,7 +112,7 @@ mongodb_mms_api_key: ""
mongodb_mms_base_url: https://mms.mongodb.com mongodb_mms_base_url: https://mms.mongodb.com
# Log rotation # Log rotation
mongodb_logrotate: true # Rotate mongodb logs. mongodb_logrotate: true # Rotate mongodb logs.
mongodb_logrotate_options: mongodb_logrotate_options:
- compress - compress
- copytruncate - copytruncate
@ -149,6 +154,7 @@ mongodb_root_admin_password: passw0rd
Add `undergreen.mongodb` to your roles and set vars in your playbook file. Add `undergreen.mongodb` to your roles and set vars in your playbook file.
Example vars for authorization: Example vars for authorization:
```yaml ```yaml
mongodb_security_authorization: "enabled" mongodb_security_authorization: "enabled"
mongodb_users: mongodb_users:
@ -159,7 +165,9 @@ mongodb_users:
database: app_development database: app_development
} }
``` ```
Example vars for oplog user: Example vars for oplog user:
```yaml ```yaml
mongodb_oplog_users: mongodb_oplog_users:
- { - {
@ -167,7 +175,9 @@ mongodb_oplog_users:
password: passw0rd password: passw0rd
} }
``` ```
Required vars to change on production: Required vars to change on production:
```yaml ```yaml
mongodb_user_admin_password mongodb_user_admin_password
mongodb_root_admin_password mongodb_root_admin_password
@ -176,17 +186,25 @@ mongodb_root_backup_password
# if you use replication and authorization # if you use replication and authorization
mongodb_security_keyfile mongodb_security_keyfile
``` ```
Example vars for replication: Example vars for replication:
```yaml ```yaml
# It's a 'master' node # It's a 'master' node
mongodb_login_host: 192.168.56.2 mongodb_login_host: 192.168.56.2
# mongodb_replication_params should be configured on each replica set node # mongodb_replication_params should be configured on each replica set node
mongodb_replication_params: mongodb_replication_params:
- { host_name: 192.168.56.2, host_port: "{{ mongodb_net_port }}", host_type: replica } - {
host_name: 192.168.56.2,
host_port: "{{ mongodb_net_port }}",
host_type: replica,
}
# host_type can be replica(default) and arbiter # host_type can be replica(default) and arbiter
``` ```
And inventory file for replica set: And inventory file for replica set:
```ini ```ini
[mongo_master] [mongo_master]
192.158.56.2 mongodb_master=True # it is't a really master of MongoDB replica set, 192.158.56.2 mongodb_master=True # it is't a really master of MongoDB replica set,

View File

@ -1,5 +1,4 @@
--- ---
dependencies: [] dependencies: []
galaxy_info: galaxy_info:
@ -9,19 +8,23 @@ galaxy_info:
license: GPLv2 license: GPLv2
min_ansible_version: 2.4 min_ansible_version: 2.4
platforms: platforms:
- name: Ubuntu - name: Ubuntu
versions: versions:
- trusty - trusty
- xenial - xenial
- bionic - bionic
- name: Debian - name: Debian
versions: versions:
- jessie - jessie
- stretch - stretch
- name: EL - name: EL
versions: versions:
- 6 - 6
- 7 - 7
- name: Amazon
versions:
- Candidate
galaxy_tags: galaxy_tags:
- database - database
- database:nosql - nosql
- mongodb

39
tasks/install.amazon.yml Normal file
View File

@ -0,0 +1,39 @@
---
- name: Establish some role-related facts
set_fact:
mongodb_major_version: "{{ mongodb_version[0:3] }}"
- name: Add YUM repository
template:
src: mongodb.repo.j2
dest: /etc/yum.repos.d/mongodb.repo
mode: 0644
with_items: "{{ mongodb_version[0:3] }}"
when: mongodb_package == 'mongodb-org'
- name: Install MongoDB package
yum:
name:
- "{{ mongodb_package }}"
- numactl
state: present
- name: Install PyMongo package
yum:
name: python-pymongo
state: latest
when: not mongodb_pymongo_from_pip
- name: Install PIP
yum:
name:
- python-devel
- python-pip
when: mongodb_pymongo_from_pip
- name: Install PyMongo from PIP
pip:
name: pymongo
state: "{{ mongodb_pymongo_pip_version is defined | ternary('present', 'latest') }}"
version: "{{ mongodb_pymongo_pip_version | default(omit) }}"
when: mongodb_pymongo_from_pip

View File

@ -8,7 +8,10 @@
- "{{ ansible_os_family }}.yml" - "{{ ansible_os_family }}.yml"
- name: Include installation tasks - name: Include installation tasks
include: "install.{{ ansible_os_family | lower }}.yml" include: "{{ item }}"
with_first_found:
- "install.{{ ansible_distribution | lower }}.yml"
- "install.{{ ansible_os_family | lower }}.yml"
tags: [mongodb] tags: [mongodb]
- name: Include configuration.yml - name: Include configuration.yml

View File

@ -0,0 +1,14 @@
FROM amazonlinux:2
# This is needed so that ansible managed to read "ansible_default_ipv4"
RUN yum install iproute -y
# This step is needed since standard CentOS docker image does not come with init-functions installed by default.
# This package seems to be required for Mongo 3.2 and downwards
RUN yum install initscripts -y
# we can has SSH
EXPOSE 22
# pepare for takeoff
CMD ["/usr/sbin/init"]

11
vars/Amazon.yml Normal file
View File

@ -0,0 +1,11 @@
---
mongodb_repository:
"4.0": "https://repo.mongodb.org/yum/amazon/2/mongodb-org/4.0/x86_64/"
"3.6": "https://repo.mongodb.org/yum/amazon/2013.03/mongodb-org/3.6/x86_64/"
"3.4": "https://repo.mongodb.org/yum/amazon/2013.03/mongodb-org/3.4/x86_64/"
mongodb_repository_gpgkey:
"4.0": "https://www.mongodb.org/static/pgp/server-4.0.asc"
"3.6": "https://www.mongodb.org/static/pgp/server-3.6.asc"
mongodb_pidfile_path: "{{ '/var/run/mongodb/mongod.pid' if ('mongodb-org' in mongodb_package) else '' }}"