community.docker.docker_machine – Источник инвентаризации Docker Machine
Примечание
Этот плагин является частью коллекции community.docker (версия 1.1.0).
Для его установки используйте: ansible-galaxy collection install community.docker.
Для использования в playbook, укажите: community.docker.docker_machine.
Описание
- Получение узлов инвентаризации из Docker Machine.
- Использует файл конфигурации YAML, заканчивающийся docker_machine.(yml|yaml).
- Плагин устанавливает стандартные переменные узлов
ansible_host,ansible_port,ansible_userиansible_ssh_private_key. - Плагин сохраняет переменные вывода ‘env’ Docker Machine в переменные узлов с префиксом dm_.
Требования
Ниже перечислены требования к локальному контроллеру узлу, который выполняет этот инвентаризатор.
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| compose словарь | По умолчанию: {} | Создать переменные из выражений jinja2. | |
| daemon_env строка |
| Нужно ли получать переменные окружения подключения к демону docker, и как вести себя, если их невозможно получить. С require и require-silently, получить их и пропустить любой узел, для которого их невозможно получить. Будет выведено предупреждение для любого пропущенного узла, если выбор require.С optional и optional-silently, получить их и не пропускать узлы, для которых их невозможно получить. Будет выведено предупреждение для узлов, где их невозможно получить, если выбор optional.С skip, не пытаться получить переменные окружения подключения к демону docker.Если получены успешно, переменные будут иметь префикс dm_ и сохранены как переменные узла. | |
| groups словарь | По умолчанию: {} | Добавить узлы в группу на основе условных выражений Jinja2. | |
| keyed_groups список / элементы=строка | По умолчанию: [] | Добавить узлы в группу на основе значений переменной. | |
| plugin строка / обязательно |
| токен, гарантирующий, что это файл исходного кода для плагина docker_machine. | |
| running_required логическое |
| если истинно, узлы, которые Docker Machine указывает в состоянии, отличном от running, будут пропущены. | |
| strict логическое |
| Если yes, сделать недопустимые записи ошибкой, иначе пропустить и продолжить.Поскольку в выражениях можно использовать факты, они могут не всегда быть доступными, и мы игнорируем эти ошибки по умолчанию. | |
| verbose_output логическое |
| если истинно, включить все доступные данные узла (например, Image, Region, Size) как JSON-объект с именем docker_machine_node_attributes. |
Примеры
# Minimal example
plugin: community.docker.docker_machine
# Example using constructed features to create a group per Docker Machine driver
# (https://docs.docker.com/machine/drivers/), e.g.:
# $ docker-machine create --driver digitalocean ... mymachine
# $ ansible-inventory -i ./path/to/docker-machine.yml --host=mymachine
# {
# ...
# "digitalocean": {
# "hosts": [
# "mymachine"
# ]
# ...
# }
strict: no
keyed_groups:
- separator: ''
key: docker_machine_node_attributes.DriverName
# Example grouping hosts by Digital Machine tag
strict: no
keyed_groups:
- prefix: tag
key: 'dm_tags'
# Example using compose to override the default SSH behaviour of asking the user to accept the remote host key
compose:
ansible_ssh_common_args: '"-o StrictHostKeyChecking=accept-new"'
Авторы
- Ximon Eighteen (@ximon18)
© 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_machine_inventory.html