docker_network – Управление сетями Docker

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

Описание

• Создание/удаление сетей Docker и подключение контейнеров к ним.
• Выполняет в основном ту же функцию, что и подкоманда «docker network» командной строки.

Требования

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

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

Параметры

Примечания

Примеры

- name: Create a network
  docker_network:
    name: network_one

- name: Remove all but selected list of containers
  docker_network:
    name: network_one
    connected:
      - container_a
      - container_b
      - container_c

- name: Remove a single container
  docker_network:
    name: network_one
    connected: "{{ fulllist|difference(['container_a']) }}"

- name: Add a container to a network, leaving existing containers connected
  docker_network:
    name: network_one
    connected:
      - container_a
    appends: yes

- name: Create a network with options
  docker_network:
    name: network_two
    driver_options:
      com.docker.network.bridge.name: net2
    ipam_options:
      subnet: '172.3.26.0/16'
      gateway: 172.3.26.1
      iprange: '192.168.1.0/24'

- name: Delete a network, disconnecting all containers
  docker_network:
    name: network_one
    state: absent
    force: yes

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

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

Статус

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

Авторы

• Ben Keith (@keitwb)
• Chris Houseknecht (@chouseknecht)