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.9/modules/mongodb_replicaset_module.html
