docker_swarm – Ansible динамический плагин инвентаризации для узлов Docker swarm
Новое в версии 2.8.
Описание
- Читает инвентаризации из API Docker swarm.
- Использует файл конфигурации YAML docker_swarm.[yml|yaml].
- Плагин возвращает следующие группы узлов swarm: all - все узлы; workers - все рабочие узлы; managers - все менеджерские узлы; leader - узел лидера swarm; nonleaders - все узлы, кроме узла лидера swarm.
Требования
Ниже приведены требования к локальному мастер-узлу, на котором выполняется эта инвентаризация.
- python >= 2.7
- Docker SDK для Python >= 1.10.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| api_version строка | Версия API Docker, работающего на узле Docker. По умолчанию используется последняя версия API, поддерживаемая docker-py. псевдонимы: docker_api_version | ||
| ca_cert путь | Используйте сертификат CA при проверке подлинности сервера, указав путь к файлу сертификата CA. псевдонимы: tls_ca_cert, cacert_path | ||
| client_cert путь | Путь к файлу сертификата TLS клиента. псевдонимы: tls_client_cert, cert_path | ||
| client_key путь | Путь к файлу ключа TLS клиента. псевдонимы: tls_client_key, key_path | ||
| compose словарь | По умолчанию: {} | Создать переменные из выражений Jinja2. | |
| docker_host строка / обязательно | Сокет узла менеджера Docker swarm ( tcp, unix).Используйте unix://var/run/docker.sock для подключения через локальный сокет.псевдонимы: docker_url | ||
| groups словарь | По умолчанию: {} | Добавить узлы в группу на основе условных выражений Jinja2. | |
| include_host_uri логическое |
| Включить дополнительное атрибут ansible_host_uri, содержащий URI лидера swarm в формате tcp://172.16.0.1:2376. Это значение можно использовать без дополнительных изменений в качестве значения параметра docker_host в модулях Docker Swarm при подключении через API. Порт всегда по умолчанию 2376. | |
| include_host_uri_port целое число | Переопределить обнаруженный номер порта, включенный в ansible_host_uri
| ||
| keyed_groups список | По умолчанию: [] | Добавить узлы в группу на основе значений переменной. | |
| plugin строка / обязательно |
| Имя этого плагина, оно всегда должно быть установлено в значение docker_swarm для того, чтобы этот плагин мог его распознать. | |
| ssl_version строка | Укажите допустимый номер версии SSL. Значение по умолчанию определяется модулем ssl.py. | ||
| strict логическое |
| Если yes считать недопустимые записи ошибкой, иначе пропустить и продолжить.Поскольку в выражениях можно использовать факты, они могут не всегда быть доступны, и мы по умолчанию игнорируем эти ошибки. | |
| timeout целое число | По умолчанию: 60 | Максимальное время ожидания ответа от API в секундах. Если значение не указано в задаче, будет использовано значение переменной окружения DOCKER_TIMEOUT. Если переменная окружения не задана, будет использовано значение по умолчанию.псевдонимы: time_out | |
| tls логическое |
| Подключиться с использованием TLS без проверки подлинности сервера Docker. | |
| tls_hostname строка | При проверке подлинности сервера Docker укажите ожидаемое имя сервера. | ||
| validate_certs логическое |
| Включить или выключить подключение через TLS с проверкой подлинности сервера Docker. псевдонимы: tls_verify | |
| verbose_output логическое |
| Включить (или выключить) отображение всех доступных метаданных узлов (например, Platform, Architecture, OS, EngineVersion). |
Примеры
# Minimal example using local docker
plugin: docker_swarm
docker_host: unix://var/run/docker.sock
# Minimal example using remote docker
plugin: docker_swarm
docker_host: tcp://my-docker-host:2375
# Example using remote docker with unverified TLS
plugin: docker_swarm
docker_host: tcp://my-docker-host:2376
tls: yes
# Example using remote docker with verified TLS and client certificate verification
plugin: docker_swarm
docker_host: tcp://my-docker-host:2376
validate_certs: yes
ca_cert: /somewhere/ca.pem
client_key: /somewhere/key.pem
client_cert: /somewhere/cert.pem
# Example using constructed features to create groups and set ansible_host
plugin: docker_swarm
docker_host: tcp://my-docker-host:2375
strict: False
keyed_groups:
# add e.g. x86_64 hosts to an arch_x86_64 group
- prefix: arch
key: 'Description.Platform.Architecture'
# add e.g. linux hosts to an os_linux group
- prefix: os
key: 'Description.Platform.OS'
# create a group per node label
# e.g. a node labeled w/ "production" ends up in group "label_production"
# hint: labels containing special characters will be converted to safe names
- key: 'Spec.Labels'
prefix: label
Статус
- Данная инвентаризация не гарантирует обратной совместимости. [превью]
- Эта инвентаризация поддерживается сообществом Ansible. [сообщество]
Авторы
- Stefan Heitmüller (@morph027) <stefan.heitmueller@gmx.com>
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
Подсказка
Элементы конфигурации для каждого типа записи имеют порядок приоритета от низкого к высокому. Например, переменная, расположенная ниже в списке, переопределит переменную, расположенную выше.
© 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/plugins/inventory/docker_swarm.html
