containers.podman.podman_network – Управление сетями podman
Примечание
Этот плагин входит в коллекцию containers.podman (версия 1.4.1).
Для его установки используйте: ansible-galaxy collection install containers.podman.
Для использования в playbook укажите: 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 (Dual Stack) сетевое подключение. Необходимо указать подсеть IPv6. Параметр subnet необходимо использовать вместе с параметром ipv6. | |
| macvlan string | Создание подключения Macvlan на основе этого устройства | ||
| name string / обязательный | Имя сети | ||
| opt словарь | Добавление сетевых опций. В настоящее время поддерживаются 'vlan' и 'mtu'. | ||
| mtu целое число | Размер MTU для сетевого интерфейса bridge. | ||
| vlan целое число | Тег VLAN для bridge, что включает vlan_filtering. | ||
| recreate boolean |
| Пересоздать сеть, даже если она существует. | |
| state строка |
| Состояние сети, по умолчанию 'present' | |
| 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/containers/podman/podman_network_module.html