containers.podman.podman_network – Управление сетями podman
Примечание
Этот плагин является частью коллекции containers.podman (версия 1.4.1).
Для его установки используйте: ansible-galaxy collection install containers.podman.
Чтобы использовать его в книге задач, укажите: containers.podman.podman_network.
В версии 1.0.0: из containers.podman
Описание
- Управление сетями podman с помощью команды podman network.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- podman
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| debug boolean |
|
Возвращает дополнительную информацию, которая может быть полезной для расследований. |
|
| disable_dns boolean |
|
отключить плагин dns (по умолчанию "false") |
|
| driver string |
Драйвер для управления сетью (по умолчанию "bridge") |
||
| executable string |
По умолчанию: "podman" |
Путь к исполняемому файлу podman, если он не находится в $PATH на машине, на которой выполняется podman |
|
| gateway string |
Шлюз IPv4 или IPv6 для подсети |
||
| internal boolean |
|
Ограничить внешний доступ из этой сети (по умолчанию "false") |
|
| ip_range string |
Выделить IP-адрес контейнера из диапазона |
||
| ipv6 boolean |
|
Включить IPv6 (сетевой стек двойной стекинг). Вы должны указать подсеть IPv6. Параметр subnet необходимо использовать с параметром ipv6. |
|
| macvlan string |
Создать подключение Macvlan на основе этого устройства |
||
| name string / обязательно |
Имя сети |
||
| opt словарь |
Добавить параметры сети. В настоящее время поддерживаются 'vlan' и 'mtu'. |
||
| mtu целое число |
Размер MTU для сетевого интерфейса bridge. |
||
| vlan целое число |
Тег VLAN для моста, который включает vlan_filtering. |
||
| recreate boolean |
|
Пересоздать сеть, даже если она существует. |
|
| state строка |
|
Состояние сети, по умолчанию 'присутствует' |
|
| subnet строка |
Подсеть в формате CIDR |
||
Примеры
- name: Create a podman network
containers.podman.podman_network:
name: podman_network
become: true
- name: Create internal podman network
containers.podman.podman_network:
name: podman_internal
internal: true
ip_range: 192.168.22.128/25
subnet: 192.168.22.0/24
gateway: 192.168.22.1
become: true
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращается | Описание |
|---|---|---|
| network список / элементы=строка |
всегда | Данные из созданных или обновленных сетей Пример: [{'cniVersion': '0.4.0', 'name': 'podman', 'plugins': [{'bridge': 'cni-podman0', 'ipMasq': True, 'ipam': {'ranges': [[{'gateway': '10.88.0.1', 'subnet': '10.88.0.0/16'}]], 'routes': [{'dst': '0.0.0.0/0'}], 'type': 'host-local'}, 'isGateway': True, 'type': 'bridge'}, {'capabilities': {'portMappings': True}, 'type': 'portmap'}, {'backend': 'iptables', 'type': 'firewall'}]}] |
Авторы
- Sagi Shnaidman (@sshnaidm)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/containers/podman/podman_network_module.html