community.mongodb.mongodb_shard – Добавление или удаление фрагментов из кластера MongoDB
Примечание
Этот плагин входит в коллекцию community.mongodb (версия 1.1.1).
Для его установки используйте: ansible-galaxy collection install community.mongodb
Чтобы использовать его в playbook, укажите: community.mongodb.mongodb_shard
Добавлено в версии 1.0.0: of community.mongodb
Описание
- Добавление или удаление фрагментов из кластера MongoDB.
Требования
Ниже перечислены требования, необходимые на хосте, на котором будет выполняться этот модуль.
- pymongo
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| auth_mechanism строка |
| Тип аутентификации. |
| connection_options список / элементы=необработанные | Дополнительные параметры подключения. Указываются как список словарей или строк, содержащих пары ключ-значение, разделенные символом «=». | |
| login_database строка | По умолчанию: "admin" | База данных, где хранятся учетные данные для входа. |
| login_host строка | По умолчанию: "localhost" | Хост, на котором работает экземпляр MongoDB для входа. |
| login_password строка | Пароль, используемый для аутентификации. Требуется, если указан параметр login_user. | |
| login_port целое число | По умолчанию: 27017 | Порт сервера MongoDB для входа. |
| login_user строка | Пользователь MongoDB для входа. Требуется, если указан параметр login_password. | |
| mongos_process строка | По умолчанию: "mongos" | Укажите пользовательское имя для процесса mongos, к которому вы подключаетесь. Большинство пользователей могут пропустить этот параметр. |
| shard строка / обязательно | Строка подключения к фрагменту. Должна быть указана в формате <replicaset>/host:port, как подробно описано в https://docs.mongodb.com/manual/tutorial/add-shards-to-shard-cluster/. Например, rs0/example1.mongodb.com:27017. | |
| sharded_databases необработанные | Включить фрагментацию для указанных баз данных. Может быть указано как строка или список строк. Отключить фрагментацию базы данных нельзя. | |
| ssl булево |
| Использовать ли SSL-соединение при подключении к базе данных. |
| ssl_ca_certs строка | Параметр ssl_ca_certs принимает путь к файлу CA. | |
| ssl_cert_reqs строка |
| Указывает, требуется ли сертификат от другой стороны соединения и будет ли он валидирован, если предоставлен. |
| ssl_certfile строка | Представить клиентский сертификат с помощью параметра ssl_certfile. | |
| ssl_crlfile строка | Параметр ssl_crlfile принимает путь к файлу CRL. | |
| ssl_keyfile строка | Приватный ключ для клиентского сертификата. | |
| ssl_pem_passphrase строка | Пароль для расшифровки зашифрованных приватных ключей. | |
| state строка |
| Нужно ли наличие фрагмента в кластере. |
Примечания
Примечание
- Требуется пакет pymongo Python на удалённом хосте, версия 2.4.2+.
Примеры
- name: Add a replicaset shard named rs1 with a member running on port 27018 on mongodb0.example.net
community.mongodb.mongodb_shard:
login_user: admin
login_password: admin
shard: "rs1/mongodb0.example.net:27018"
state: present
- name: Add a standalone mongod shard running on port 27018 of mongodb0.example.net
community.mongodb.mongodb_shard:
login_user: admin
login_password: admin
shard: "mongodb0.example.net:27018"
state: present
- name: To remove a shard called 'rs1'
community.mongodb.mongodb_shard:
login_user: admin
login_password: admin
shard: rs1
state: absent
# Single node shard running on localhost
- name: Ensure shard rs0 exists
community.mongodb.mongodb_shard:
login_user: admin
login_password: secret
shard: "rs0/localhost:3001"
state: present
# Single node shard running on localhost
- name: Ensure shard rs1 exists
community.mongodb.mongodb_shard:
login_user: admin
login_password: secret
shard: "rs1/localhost:3002"
state: present
# Enable sharding on a few databases when creating the shard
- name: To remove a shard called 'rs1'
community.mongodb.mongodb_shard:
login_user: admin
login_password: admin
shard: rs1
sharded_databases:
- db1
- db2
state: present
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| mongodb_shard строка | успех | Имя фрагмента, который нужно создать. |
| sharded_enabled список / элементы=строка | успех, когда фрагментация включена | Базы данных, для которых фрагментация была включена во время выполнения модуля. |
Авторы
- Rhys Campbell (@rhysmeister)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/mongodb/mongodb_shard_module.html
