docker_config – Управление конфигурациями docker

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

Обзор

• Создание и удаление конфигураций Docker в среде Swarm. Аналогично docker config create и docker config rm.
• Добавляет в метаданные новых конфигураций «ansible_key», зашифрованное хеш-представление данных, которое затем используется в будущих запусках для проверки изменения конфигурации. Если «ansible_key» отсутствует, конфигурация не будет обновлена, если не установлен параметр force.
• Обновления конфигураций выполняются путем удаления конфигурации и повторного её создания.

Требования

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

• Docker API >= 1.30
• Docker SDK для Python: Обратите внимание, что модуль Python docker-py был заменён на docker (см. здесь для получения подробностей). Этот модуль не работает с docker-py.
• Docker SDK для Python >= 2.6.0
• Python >= 2.7

Параметры

Примечания

Примеры

- name: Create config foo (from a file on the control machine)
  docker_config:
    name: foo
    # If the file is JSON or binary, Ansible might modify it (because
    # it is first decoded and later re-encoded). Base64-encoding the
    # file directly after reading it prevents this to happen.
    data: "{{ lookup('file', '/path/to/config/file') | b64encode }}"
    data_is_b64: true
    state: present

- name: Change the config data
  docker_config:
    name: foo
    data: Goodnight everyone!
    labels:
      bar: baz
      one: '1'
    state: present

- name: Add a new label
  docker_config:
    name: foo
    data: Goodnight everyone!
    labels:
      bar: baz
      one: '1'
      # Adding a new label will cause a remove/create of the config
      two: '2'
    state: present

- name: No change
  docker_config:
    name: foo
    data: Goodnight everyone!
    labels:
      bar: baz
      one: '1'
      # Even though 'two' is missing, there is no change to the existing config
    state: present

- name: Update an existing label
  docker_config:
    name: foo
    data: Goodnight everyone!
    labels:
      bar: monkey   # Changing a label will cause a remove/create of the config
      one: '1'
    state: present

- name: Force the (re-)creation of the config
  docker_config:
    name: foo
    data: Goodnight everyone!
    force: yes
    state: present

- name: Remove config foo
  docker_config:
    name: foo
    state: absent

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

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

Статус

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

Авторы

• Chris Houseknecht (@chouseknecht)
• John Hu (@ushuz)