Category | Status |
---|---|
Github CI | |
Github Docs | |
Codecov | |
Travis MongoDB Roles | |
MongoDB Clusters | |
Latest Build |
This collection called mongodb
aims at providing all Ansible modules allowing to interact with MongoDB.
The modules present in Ansible 2.9 are included in this collection and will benefit from the evolutions and quality requirements from this collection.
As this is an independent Collection, it can be release on it's own release cadance.
-
Requirements
- Python 3.5+
- pip
- virtualenv or pipenv if you prefer.
- git
- docker
-
Useful Links
The ansible-test tool requires a specific directory hierarchy to function correctly so please follow carefully.
- Create the required directory structure. N-B. The ansible-test tool requires this format...
mkdir -p git/ansible_collections/community
cd git/ansible_collections/community
- Clone the required projects...
git clone https://github.com/ansible-collections/community.mongodb.git ./mongodb
git clone https://github.com/ansible-collections/community.general.git ./general
- Create and activate a virtual environment...
virtualenv venv
source venv/bin/activate
- Change to project directory...
cd mongodb
- Install the devel branch of ansible-base...
pip install https://github.com/ansible/ansible/archive/devel.tar.gz --disable-pip-version-check
- Run integration tests for the mongodb_shard module.
ansible-test integration --docker default -v --color --python 3.6 mongodb_shard
- Run integration tests for the mongodb_status module.
ansible-test integration --docker default -v --color --python 3.6 mongodb_status
- Run integration tests for the mongodb_oplog module.
ansible-test integration --docker ubuntu1804 -v --color --python 3.6 mongodb_oplog
- Run tests for everything in the collection.
ansible-test integration --docker default -v --color --python 3.6
- Run the units tests
ansible-test units --docker default -v --color --python 3.6
- Maintainers would be members of this GitHub Repo
- Branch protections could be used to enforce 1 (or 2) reviews from relevant maintainers CODEOWNERS
Any contribution is welcome and we only ask contributors to:
- Provide at least integration tests for any contribution.
- Create an issues for any significant contribution that would change a large portion of the code base.
GNU General Public License v3.0 or later
See LICENCING to see the full text.