docker_stack – модуль docker stack

Новая версия 2.8.

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

Описание

Управление стеками Docker с помощью команды «docker stack» на целевом узле (см. примеры).

Требования

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

jsondiff
pyyaml

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
absent_retries целое число	Значение по умолчанию: 0	Если `>0` и state равен `absent`, модуль будет повторно пытаться удалить стек до absent_retries раз, пока все ресурсы не будут эффективно удалены. Если последняя попытка по-прежнему сообщает, что стек не удален полностью, модуль завершится с ошибкой.
absent_retries_interval целое число	Значение по умолчанию: 1	Интервал в секундах между последовательными absent_retries.
compose список	Значение по умолчанию: []	Список определений compose. Любой элемент может быть строкой, указывающей путь к файлу compose на целевом хосте, или содержимым YAML-файла compose, вложенным как словарь.
name строка / обязательно		Имя стека
prune булево	Варианты: нет ← да	Если true, добавит параметр `--prune` к команде `docker stack deploy`. Это позволит docker удалить сервисы, отсутствующие в текущем определении стека.
resolve_image строка	Варианты: всегда изменённые никогда	Если установлено, добавит параметр `--resolve-image` к команде `docker stack deploy`. Это заставит docker запросить у реестра информацию о дайджестах изображений и поддерживаемых платформах. Если не указано, docker использует «всегда» по умолчанию.
state строка	Варианты: наличие ← отсутствие	Состояние службы.
with_registry_auth булево	Варианты: нет ← да	Если true, добавит параметр `--with-registry-auth` к команде `docker stack deploy`. Это заставит docker отправить данные аутентификации реестра агентам Swarm.

Примеры

- name: Deploy stack from a compose file
  docker_stack:
    state: present
    name: mystack
    compose:
      - /opt/docker-compose.yml

- name: Deploy stack from base compose file and override the web service
  docker_stack:
    state: present
    name: mystack
    compose:
      - /opt/docker-compose.yml
      - version: '3'
        services:
          web:
            image: nginx:latest
            environment:
              ENVVAR: envvar

- name: Remove stack
  docker_stack:
    name: mystack
    state: absent

Возвращаемые значения

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

Ключ	Возвращаемое значение	Описание
stack_spec_diff словарь	при изменении	словарь, содержащий различия между полем «Spec» служб стека до и после применения нового определения стека. Пример: "stack_spec_diff": {'test_stack_test_service': {u'TaskTemplate': {u'ContainerSpec': {delete: [u'Env']}}}}

Статус

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

Авторы

Dario Zanzico (@dariko)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете редактировать этот документ, чтобы улучшить его.

© 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/modules/docker_stack_module.html