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.8/plugins/inventory/docker_swarm.html
