docker_swarm_info – Извлечение сведений о кластере Docker Swarm

• Описание
• Требования
• Параметры
• Примечания
• Примеры
• Возвращаемые значения
• Статус

Описание

• Извлекает сведения о кластере Docker Swarm.
• Возвращает списки имён объектов Swarm для служб — узлы, службы, задачи.
• Вывод отличается в зависимости от версии API, доступной на хосте Docker.
• Должен выполняться на узле Swarm Manager; в противном случае модуль завершается ошибкой. Он возвращает логические флаги как при ошибке, так и при успехе, которые указывают, может ли с ним взаимодействовать демон Docker, находится ли он в режиме Swarm и является ли он узлом Swarm Manager.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

• API Docker >= 1.24
• Docker SDK для Python: Обратите внимание, что модуль Python docker-py был заменён на docker (подробнее см. здесь). Для Python 2.6 необходимо использовать docker-py. В противном случае рекомендуется установить модуль Python docker. Обратите внимание, что оба модуля не должны устанавливаться одновременно. Также обратите внимание, что если оба модуля установлены, а один из них удалён, другой может перестать работать, и потребуется его переустановка.
• Docker SDK для Python >= 1.10.0 (используйте docker-py для Python 2.6)

Параметры

Примечания

Примеры

- name: Get info on Docker Swarm
  docker_swarm_info:
  ignore_errors: yes
  register: result

- name: Inform about basic flags
  debug:
    msg: |
      Was able to talk to docker daemon: {{ result.can_talk_to_docker }}
      Docker in Swarm mode: {{ result.docker_swarm_active }}
      This is a Manager node: {{ result.docker_swarm_manager }}

- block:

- name: Get info on Docker Swarm and list of registered nodes
  docker_swarm_info:
    nodes: yes
  register: result

- name: Get info on Docker Swarm and extended list of registered nodes
  docker_swarm_info:
    nodes: yes
    verbose_output: yes
  register: result

- name: Get info on Docker Swarm and filtered list of registered nodes
  docker_swarm_info:
    nodes: yes
    nodes_filter:
      name: mynode
  register: result

- debug:
    var: result.swarm_facts

- name: Get the swarm unlock key
  docker_swarm_info:
    unlock_key: yes
  register: result

- debug:
    var: result.swarm_unlock_key

Значения возврата

Общие значения возврата описаны в здесь, следующие являются полями, уникальными для этого модуля:

Статус

• Данный модуль не гарантирует обратной совместимости. [превью]
• Этот модуль поддерживается сообществом Ansible. [community]

Авторы

• Piotr Wojciechowski (@WojciechowskiPiotr)