community.general.docker_swarm_info – Получает сведения о кластере Docker Swarm.

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

Обзор

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

Требования

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

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

Параметры

Примечания

Примеры

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

- name: Inform about basic flags
  ansible.builtin.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
  community.general.docker_swarm_info:
    nodes: yes
  register: result

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

- name: Get info on Docker Swarm and filtered list of registered nodes
  community.general.docker_swarm_info:
    nodes: yes
    nodes_filters:
      name: mynode
  register: result

- ansible.builtin.debug:
    var: result.swarm_facts

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

- ansible.builtin.debug:
    var: result.swarm_unlock_key

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

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

Авторы

• Piotr Wojciechowski (@WojciechowskiPiotr)