community.docker.docker_swarm – Плагин динамической инвентаризации Ansible для узлов Docker swarm.
Примечание
Этот плагин является частью коллекции community.docker (версия 1.1.0).
Для его установки используйте: ansible-galaxy collection install community.docker.
Чтобы использовать его в плейбуке, укажите: community.docker.docker_swarm.
Обзор
- Считывает инвентаризацию из 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 строка | Версия Docker API, работающая на хосте 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 строка / обязательно |
| Имя этого плагина, которое должно всегда устанавливаться в community.docker.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: community.docker.docker_swarm
docker_host: unix://var/run/docker.sock
# Minimal example using remote docker
plugin: community.docker.docker_swarm
docker_host: tcp://my-docker-host:2375
# Example using remote docker with unverified TLS
plugin: community.docker.docker_swarm
docker_host: tcp://my-docker-host:2376
tls: yes
# Example using remote docker with verified TLS and client certificate verification
plugin: community.docker.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: community.docker.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
Авторы
- 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.10/collections/community/docker/docker_swarm_inventory.html
