os_subnet - Добавление/удаление подсети в сеть OpenStack

Новая в версии 2.0.

Обзор
Требования (к хосту, на котором выполняется модуль)
Параметры
Примеры
Примечания
- Статус

Обзор

Добавление или удаление подсети в сеть OpenStack

Требования (к хосту, на котором выполняется модуль)

python >= 2.6
python >= 2.7
shade

Параметры

параметр	обязательно	по умолчанию	варианты	комментарии
allocation_pool_end	нет	None		Последний IP-адрес из пула подсетей, который должен быть назначен виртуальным машинам.
allocation_pool_start	нет	None		Начальный адрес из пула подсетей, с которого должен быть выделен IP-адрес.
api_timeout	нет	None		Время ожидания сокетом перед истечением времени ожидания для вызовов API. Если этот параметр опущен, ничего не будет передано библиотеке requests.
auth	нет			Словарь, содержащий информацию об авторизации, необходимую стратегии подключаемого модуля для авторизации облака. Для стандартного плагина password он будет содержать auth_url, username, password, project_name и любую информацию о домене, если облако её поддерживает. Для других плагинов этот параметр должен содержать необходимые параметры плагина авторизации. Этот параметр не нужен, если указано имя облака или присутствуют переменные окружения OpenStack OS_*.
auth_type	нет	password		Имя плагина авторизации для использования. Если облако использует что-то кроме парольной аутентификации, здесь должно быть указано имя плагина, и содержимое параметра auth должно быть соответствующим образом обновлено.
availability_zone	нет			Игнорируется. Присутствует для обратной совместимости
cacert	нет	None		Путь к пакету сертификатов CA, который может использоваться для проверки запросов API SSL.
cert	нет	None		Путь к клиентскому сертификату, который следует использовать в ходе SSL-транзакции.
cidr	нет	None		Представление CIDR подсети, которая должна быть назначена подсети. Требуется, когда state равен 'present' и не указан subnetpool.
cloud	нет			Имя облака, по которому нужно выполнить операцию. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан auth или присутствуют переменные окружения OpenStack OS_*.
dns_nameservers	нет	None		Список DNS-серверов для этой подсети.
enable_dhcp	нет	True		Включить DHCP для этой подсети.
endpoint_type	нет	public	public internal admin	Тип URL-адреса конечной точки для извлечения из каталога сервисов.
gateway_ip	нет	None		IP-адрес, который будет назначен шлюзу для этой подсети
host_routes	нет	None		Список словарей маршрутов хоста для подсети.
ip_version	нет	4		Версия IP-адреса подсети 4 или 6
ipv6_address_mode	нет	None	dhcpv6-stateful dhcpv6-stateless slaac	Режим адресации IPv6
ipv6_ra_mode	нет	None	dhcpv6-stateful dhcpv6-stateless slaac	Режим рекламы маршрутизатора IPv6
key	нет	None		Путь к клиенту ключа для использования в ходе SSL-транзакции.
name	да			Имя подсети, которая должна быть создана. Хотя Neutron допускает использование не уникальных имён подсетей, этот модуль требует уникальности имён подсетей.
network_name	нет			Имя сети, к которой должна быть подключена подсеть Требуется, когда state равен 'present'
no_gateway_ip (добавлен в 2.2)	нет			IP-адрес шлюза не будет назначен для этой подсети
project (добавлен в 2.1)	нет	None		Имя или ID проекта, содержащего подсеть (только для администратора)
region_name	нет			Имя региона.
state	нет	present	present absent	Указывает желаемое состояние ресурса
timeout	нет	180		Время ожидания Ansible для запрошенного ресурса.
use_default_subnetpool	нет			Использовать стандартный subnetpool для ip_version для получения CIDR.
validate_certs	нет			Необходимо ли проверять запросы API SSL. До версии 2.3 по умолчанию было True. псевдонимы: verify
wait	нет	yes	yes no	Должен ли Ansible ждать завершения запрошенного ресурса.

Примеры

# Create a new (or update an existing) subnet on the specified network
- os_subnet:
    state: present
    network_name: network1
    name: net1subnet
    cidr: 192.168.0.0/24
    dns_nameservers:
       - 8.8.8.7
       - 8.8.8.8
    host_routes:
       - destination: 0.0.0.0/0
         nexthop: 12.34.56.78
       - destination: 192.168.0.0/24
         nexthop: 192.168.0.1

# Delete a subnet
- os_subnet:
    state: absent
    name: net1subnet

# Create an ipv6 stateless subnet
- os_subnet:
    state: present
    name: intv6
    network_name: internal
    ip_version: 6
    cidr: 2db8:1::/64
    dns_nameservers:
        - 2001:4860:4860::8888
        - 2001:4860:4860::8844
    ipv6_ra_mode: dhcpv6-stateless
    ipv6_address_mode: dhcpv6-stateless

Примечания

Примечание

Можно использовать стандартные переменные среды OpenStack, такие как OS_USERNAME вместо явного указания значений.
Информация об авторизации управляется os-client-config, что означает, что значения могут поступать из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных среды, а в последнюю очередь из явных параметров в заданиях. Дополнительную информацию можно найти по адресу http://docs.openstack.org/developer/os-client-config

Статус

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.

Для получения помощи в разработке модулей, если вы в этом заинтересованы, пожалуйста, прочтите Справочная информация по сообществу и вклад, Тестирование Ansible и Разработка модулей.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/os_subnet_module.html