community.docker.docker_swarm_info – Извлекает сведения о кластере Docker Swarm.

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

Обзор

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

Требования

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

• Docker API >= 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
  community.docker.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.docker.docker_swarm_info:
    nodes: yes
  register: result

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

- name: Get info on Docker Swarm and filtered list of registered nodes
  community.docker.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.docker.docker_swarm_info:
    unlock_key: yes
  register: result

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

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

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

Авторы

• Piotr Wojciechowski (@WojciechowskiPiotr)