ancestor: null releases: 1.0.0: changes: release_summary: | The first stable release of the commmunity.mongodb collection. Many of the plugins and modules were previously released in ansible itself. modules: - description: Manages the MongoDB Sharded Cluster Balancer. name: mongodb_balancer namespace: '' - description: Creates or drops indexes on MongoDB collections. name: mongodb_index namespace: '' - description: Gather information about MongoDB instance. name: mongodb_info namespace: '' - description: Enables or disables maintenance mode for a secondary member. name: mongodb_maintenance namespace: '' - description: Resizes the MongoDB oplog. name: mongodb_oplog namespace: '' - description: Change an administrative parameter on a MongoDB server name: mongodb_parameter namespace: '' - description: Initialises a MongoDB replicaset. name: mongodb_replicaset namespace: '' - description: Add or remove shards from a MongoDB Cluster name: mongodb_shard namespace: '' - description: Cleans up all database resources and then terminates the mongod/mongos process. name: mongodb_shutdown namespace: '' - description: Validates the status of the cluster. name: mongodb_status namespace: '' - description: Step down the MongoDB node from a PRIMARY state. name: mongodb_stepdown namespace: '' - description: Adds or removes a user from a MongoDB database name: mongodb_user namespace: '' plugins: cache: - description: This cache uses per host records saved in MongoDB. name: mongodb namespace: '' lookup: - description: 'The ``MongoDB`` lookup runs the *find()* command on a given *collection* on a given *MongoDB* server.' name: mongodb namespace: '' objects: role: - description: Configure the CSRS Config Server Replicaset for a MongoDB sharded cluster. (Use mongodb_mongod for Standalone installations - this does not create mongo.conf) name: mongodb_config namespace: null - description: Install MongoDB packages on Debian and RedHat based platforms. name: mongodb_install namespace: null - description: A simple role to configure Linux Operating System settings, as advised in the MongoDB Production Notes. name: mongodb_linux namespace: null - description: Configure the mongod service (includes populating mongod.conf) which is a MongoDB replicaset or standalone server. name: mongodb_mongod namespace: null - description: Configure the mongos service (includes populating mongos.conf) which only runs in a sharded MongoDB cluster. name: mongodb_mongos namespace: null - description: Configures a package repository for MongoDB on Debian and RedHat based platforms. name: mongodb_repository namespace: null - description: Configure SELinux for MongoDB. name: mongodb_selinux namespace: null release_date: '2020-08-06' 1.1.0: changes: release_summary: | This release adds the mongodb_shell module and the mongodb_auth role. modules: - description: Run commands via the MongoDB shell. name: mongodb_shell namespace: '' objects: role: - description: Configure auth on MongoDB servers. name: mongodb_auth namespace: null release_date: '2020-10-24' 1.1.1: changes: bugfixes: - 235 - Fix namespace. release_date: '2020-11-04' 1.1.2: changes: bugfixes: - 252 - Fix config template override in various roles. - 255 - Add replica_set param to mongodb_index module. - 264 - Only add force parameter to shutdown command when set to true. - 275 - Use OrderedDict class in the following modules, mongodb_balancer, mongodb_oplog, mongodb_shutdown. release_date: '2021-01-06' 1.2.0: changes: release_summary: | A variety of idempotency and reliability improvements. bugfixes: - 281 - mongodb_linux Fixes disable-transparent-huge-pages.service idempotency. - 282 - Add restart handler, and bool variable to control to mongofb_config/mongod/mongos roles. - 285 - Output users and roles dict by database to avoid overwriting entries. - 287 - Fixes return value on older versions of MongoDB. - 290 - Adds pseudo-idempotency feature to module. release_date: '2021-01-31' 1.2.1: changes: minor_changes: - 304 - Adds validate parameter to mongodb_status module. release_date: '2021-02-09' 1.3.0: changes: release_summary: | This release improves sharded cluster management, and adds schema validator management. Several bug fixes improve compatibility with python3.6. security_fixes: - 312 - Set no_log True for ssl_keyfile. bugfixes: - 315 - Fix exception handling for mongodb_stepdown module on python3.6 - 320 - Fix exception handling for modules mongodb_balancer, mongodb_shard, and mongodb_status. - 352 - Add ansible.posix collection to dependencies list. minor_changes: - 338 - role monogdb_repository - Variablize repository details. - 345 - roles mongodb_config, mongodb_mongod, mongodb_mongos - Make security.keyFile configurable. - 346 - roles mongodb_config, mongodb_mongod, mongodb_mongos - Allow using net.bindIpAll instead of net.bindIp. - 347 - roles mongodb_config, mongodb_mongod, mongodb_mongos - Allow overriding net.compression.compressors in mongo*.conf modules: - description: Manages the free monitoring feature. name: mongodb_monitoring namespace: '' - description: Manages MongoDB Document Schema Validators. name: mongodb_schema namespace: '' - description: Manage Shard Tags. name: mongodb_shard_tag namespace: '' - description: Manage Shard Zones. name: mongodb_shard_zone namespace: '' release_date: '2021-07-20' 1.3.1: release_summary: | This release is a maintenance release. The GitHub CI has been updated to include MongoDB 5.0 as well as a few new features. The mongosh shell is now supported in the mongodb_shell module. Support for the old mongo shell will be removed in a future release. minor_changes: - 360 - mongodb_shell - Adds support for the mongosh shell now available with MongoDB 5.0. - 368 - mongodb_shell - Use shlex escape function. - 370 - mongodb_install - Adds mongodb_hold_packages variable. Runs the lock_mongodb_packages.sh script to either lock mongodb-org packages at a specific version or to release the lock. Set to "HOLD" or "NOHOLD" as desired. No checks are made to see if the hold already exists or not. By default this variable is undefined and the script is not executed. The task is executed at the end and it is possible that packages could be upgraded before the lock is initially applied. deprecated_features: - mongodb_shell - Support for the mongo shell is deprecated and will be removed in a future version. 1.3.2: release_summary: | This release is a maintenance release. minor_changes: - 413 - mongodb_shell - Adds escape_param function that will work better across various python versions. - 414-416 - Minor documentation improvements. - 411 - mongodb_shell - FIx missing db parameter when fiel parmeter is used. - 403 - Make db path configurable in roles. - 401 - mongodb_replicaset - Add further examples. - 399 - Removes unused imports from modules. - 396 - Add tags to roles. - 387 - Fix documentation for mongod cache plugin. major_changes: - 397 & 376 - mongodb_replicaset - Add reconfigure abilities to module. Add and removes members from replicasets. 1.3.3: release_summary: | This release is a maintenance release. bugfixes: - 448 - Fix issue in roles where mongod does not restart when a custom bind_ip is set. - 440 - Fix incorrect alias ssl_crlfile. - 450 - Fix issues with mongodb_replicaset connecting with the pymongo 4.0.X driver. minor_changes: - 450 - mongodb_replicaset. Introduce cluster_cmd parameter. Can be set to isMaster or hello. hello is the default. isMaster is useful for older versions of MongoDB. See [db.hello()](https://www.mongodb.com/docs/manual/reference/method/db.hello/) for more.