mongodb_replicaset – Инициализация реплицируемого набора MongoDB
Новая версия с 2.8.
Описание
- Инициализирует реплицируемый набор MongoDB в новом развертывании.
- Проверяет имя реплицируемого набора для существующих развертываний.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- pymongo
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| arbiter_at_index целое число | Определяет позицию члена в массиве, являющегося арбитром. | |
| chaining_allowed логическое значение |
| Когда settings.chaining_allowed=true, реплицируемый набор позволяет вторичным членам осуществлять репликацию с других вторичных членов. Когда settings.chaining_allowed=false, вторичные члены могут осуществлять репликацию только с первичного. |
| election_timeout_millis целое число | Значение по умолчанию: 10000 | Срок ожидания в миллисекундах для определения, когда первичный член реплицируемого набора недоступен. |
| heartbeat_timeout_secs целое число | Значение по умолчанию: 10 | Количество секунд, которое члены реплицируемого набора ожидают успешного ответа от каждого другого члена. Если член не отвечает вовремя, другие члены отмечают проблемного члена как недоступного. Это значение применяется только при использовании protocol_version=0. При использовании protocol_version=1 соответствующим параметром является settings.election_timeout_millis. |
| login_database строка | Значение по умолчанию: "admin" | База данных, в которой хранятся учетные данные для входа. |
| login_host строка | Значение по умолчанию: "localhost" | Имя хоста MongoDB. |
| login_password строка | Пароль для аутентификации. | |
| login_port целое число | Значение по умолчанию: 27017 | Порт MongoDB для входа. |
| login_user строка | Имя пользователя для аутентификации. | |
| members список | Строка, разделённая запятыми, или список YAML, содержащий члены реплицируемого набора. Укажите как простую строку, разделённую запятыми, например: mongodb1:27017,mongodb2:27017,mongodb3:27017. Если номер порта не указан, используется значение 27017. | |
| protocol_version целое число |
| Версия протокола выбора первичного члена реплицируемого набора. |
| replica_set строка | Значение по умолчанию: "rs0" | Имя реплицируемого набора. |
| ssl логическое значение |
| Использовать ли подключение SSL при подключении к базе данных. |
| ssl_cert_reqs строка |
| Указывает, требуется ли сертификат от другой стороны подключения и будет ли он проверен, если предоставлен. |
| validate логическое значение |
| Выполняет некоторые базовые проверки предоставленной конфигурации реплицируемого набора. |
Примечания
Примечание
- Требуется пакет pymongo Python на удалённом хосте, версия 2.4.2+. Его можно установить с помощью pip или менеджера пакетов операционной системы. @см. http://api.mongodb.org/python/current/installation.html
Примеры
# Create a replicaset called 'rs0' with the 3 provided members
- name: Ensure replicaset rs0 exists
mongodb_replicaset:
login_host: localhost
login_user: admin
login_password: admin
replica_set: rs0
members:
- mongodb1:27017
- mongodb2:27017
- mongodb3:27017
when: groups.mongod.index(inventory_hostname) == 0
# Create two single-node replicasets on the localhost for testing
- name: Ensure replicaset rs0 exists
mongodb_replicaset:
login_host: localhost
login_port: 3001
login_user: admin
login_password: secret
login_database: admin
replica_set: rs0
members: localhost:3001
validate: no
- name: Ensure replicaset rs1 exists
mongodb_replicaset:
login_host: localhost
login_port: 3002
login_user: admin
login_password: secret
login_database: admin
replica_set: rs1
members: localhost:3002
validate: no
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| mongodb_replicaset строка | успех | Имя созданного реплицируемого набора. |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.8/modules/mongodb_replicaset_module.html
