Модуль community.proxmox.proxmox_zone — управление конфигурациями зон Proxmox.

Примечание

Этот модуль входит в коллекцию community.proxmox (версия 1.6.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.proxmox. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать его в плейбуке, укажите: community.proxmox.proxmox_zone.

Добавлено в community.proxmox 1.4.0

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

Краткое описание

Создание, обновление и удаление зон SDN в Proxmox.

Требования

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

proxmoxer >= 2.0
requests

Параметры

Параметр	Комментарии
advertise_subnets boolean	Анонсировать подсети EVPN, если в сети есть молчащие хосты. Варианты: `false` `true`
api_host string / обязательный	Укажите целевой хост кластера Proxmox VE. Если параметр не указан, используется переменная окружения `PROXMOX_HOST`.
api_password string	Укажите пароль для аутентификации. Если параметр не указан, используется переменная окружения `PROXMOX_PASSWORD`.
api_port integer	Укажите целевой порт кластера Proxmox VE. Если параметр не указан, используется переменная окружения `PROXMOX_PORT`.
api_timeout integer	Ограничение времени выполнения запросов к API Proxmox VE. По умолчанию: `5`
api_token_id string	Укажите идентификатор токена. Если параметр не указан, используется переменная окружения `PROXMOX_TOKEN_ID`.
api_token_secret string	Укажите секретный ключ токена. Если параметр не указан, используется переменная окружения `PROXMOX_TOKEN_SECRET`.
api_user string / обязательный	Укажите пользователя для аутентификации. Если параметр не указан, используется переменная окружения `PROXMOX_USER`.
bridge string	Укажите используемый интерфейс моста.
bridge_disable_mac_learning boolean	Отключить автоматическое изучение MAC-адресов на интерфейсе моста. Варианты: `false` `true`
ca_path path	Путь к локальному сертификату, который будет использоваться для проверки TLS-соединений. Игнорируется, если `validate_certs=false`.
controller string	Имя маршрутизатора FRR.
dhcp string	Тип серверной части DHCP для этой зоны. Варианты: `"dnsmasq"`
disable_arp_nd_suppression boolean	Отключить подавление ARP для IPv4 и обнаружения соседей для IPv6. Варианты: `false` `true`
dns string	Сервер API DNS.
dnszone string	Доменная зона DNS.
dp_id integer	Идентификатор плоскости передачи данных Faucet.
exitnodes string	Список имен узлов кластера.
exitnodes_local_routing boolean	Разрешить узлам выхода подключаться к гостевым системам EVPN. Варианты: `false` `true`
exitnodes_primary string	В первую очередь направлять трафик через этот узел выхода.
fabric string	Фабрика SDN, используемая как базовая сеть для этой зоны VXLAN. Для зон VXLAN требуется указать либо `fabric`, либо `peers`.
ipam string	Использовать указанную систему IPAM.
mac string	MAC-адрес логического маршрутизатора anycast.
mtu integer	Задать максимальный размер блока передачи (MTU).
nodes string	Список имен узлов кластера.
peers string	Список адресов пиров (IP-адреса, разделенные запятыми). Для зон VXLAN требуется указать либо `fabric`, либо `peers`. Пример: 192.168.0.1,192.168.0.2,192.168.0.3
reversedns string	Сервер API обратного DNS.
rt_import string	Импорт целевого маршрута (Route Target).
state string	Требуемое состояние конфигурации зоны. Варианты: `"present"` ← (по умолчанию) `"absent"`
tag integer	Тег Service VLAN.
type string	Укажите тип зоны. Варианты: `"evpn"` `"faucet"` `"qinq"` `"simple"` `"vlan"` `"vxlan"`
update boolean	Если `state=present` и зона существует, она будет обновлена. Варианты: `false` `true` ← (по умолчанию)
validate_certs boolean	Проверять TLS-сертификаты, используемые для подключения к API Proxmox VE. В настоящее время по умолчанию используется `false`; в community.proxmox 2.0.0 значение по умолчанию изменится на `true`. Если параметр не указан, используется переменная окружения `PROXMOX_VALIDATE_CERTS`. Варианты: `false` `true`
vlan_protocol string	Укажите используемый протокол VLAN. Варианты: `"802.1q"` `"802.1ad"`
vrf_vxlan integer	Укажите идентификатор VRF VXLAN.
vxlan_port integer	UDP-порт туннеля VXLAN (по умолчанию 4789).
zone string	Уникальное имя зоны.

Атрибуты

Атрибут	Поддержка	Описание
action_group	Группа действий: community.proxmox.proxmox	Используйте `group/community.proxmox.proxmox` в `module_defaults`, чтобы задать значения по умолчанию для этого модуля.
check_mode	Поддержка: нет	Модуль может выполняться в режиме `check_mode` и возвращать прогноз изменения состояния без изменения целевого объекта.
diff_mode	Поддержка: нет	В режиме diff будут возвращены сведения об изменениях (или возможных изменениях в `check_mode`).

Примеры

- name: Create a simple zone
  community.proxmox.proxmox_zone:
    api_user: "root@pam"
    api_password: "{{ vault.proxmox.root_password }}"
    api_host: "{{ pc.proxmox.api_host }}"
    validate_certs: false
    type: simple
    zone: ansible
    state: present

- name: Create a vlan zone
  community.proxmox.proxmox_zone:
    api_user: "root@pam"
    api_password: "{{ vault.proxmox.root_password }}"
    api_host: "{{ pc.proxmox.api_host }}"
    validate_certs: false
    type: vlan
    zone: ansible
    state: present
    bridge: vmbr0

- name: Create a VXLAN zone with fabric
  community.proxmox.proxmox_zone:
    api_user: "root@pam"
    api_password: "{{ vault.proxmox.root_password }}"
    api_host: "{{ pc.proxmox.api_host }}"
    validate_certs: false
    type: vxlan
    zone: myvxlan
    fabric: my_fabric
    state: present

- name: Create a VXLAN zone with peers
  community.proxmox.proxmox_zone:
    api_user: "root@pam"
    api_password: "{{ vault.proxmox.root_password }}"
    api_host: "{{ pc.proxmox.api_host }}"
    validate_certs: false
    type: vxlan
    zone: myvxlan
    peers: "192.168.0.1,192.168.0.2,192.168.0.3"
    state: present

- name: Delete a zone
  community.proxmox.proxmox_zone:
    api_user: "root@pam"
    api_password: "{{ vault.proxmox.root_password }}"
    api_host: "{{ pc.proxmox.api_host }}"
    validate_certs: false
    type: simple
    zone: ansible
    state: absent

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

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

Ключ	Описание
zone string	Имя созданной, обновленной или удаленной зоны Возвращается: при успешном выполнении Пример: `"test"`

Авторы

Jana Hoch

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/proxmox/proxmox_zone_module.html