os_subnet - Добавление/удаление подсети в сеть OpenStack
Новое в версии 2.0.
Обзор
- Добавление или удаление подсети в сеть OpenStack
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- openstacksdk
- python >= 2.7
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| allocation_pool_end | Последний IP-адрес в пуле подсетей, который должен быть назначен виртуальным машинам. | |
| allocation_pool_start | Начальный адрес в пуле подсетей, с которого должен быть выделен IP-адрес. | |
| api_timeout | Время ожидания сокетом перед истечением срока действия для вызовов API. Если это значение опущено, библиотека requests ничего не получит. | |
| auth | Словарь, содержащий информацию об авторизации, необходимую для стратегии подключаемого модуля авторизации облака. Для стандартного подключаемого модуля password он содержит auth_url, username, password, project_name и любую информацию о доменах, если облако их поддерживает. Для других подключаемых модулей этот параметр должен содержать необходимые параметры. Этот параметр не требуется, если указано имя облака или присутствуют переменные среды OpenStack OS_*. | |
| auth_type | Имя подключаемого модуля авторизации для использования. Если облако использует что-то помимо аутентификации по паролю, здесь следует указать имя подключаемого модуля, и содержимое параметра auth должно быть соответствующим образом обновлено. | |
| availability_zone | Игнорируется. Присутствует для обратной совместимости. | |
| cacert | Путь к пакету сертификатов CA, который может использоваться для проверки запросов API SSL. | |
| cert | Путь к клиенту сертификат для использования в ходе транзакции SSL. | |
| cidr | Представление CIDR подсети, которая должна быть назначена подсети. Требуется, когда state равно 'present', и не указан subnetpool. | |
| cloud | Именованное облако или конфигурация облака для работы. Если cloud — строка, она ссылается на именованную конфигурацию облака, как определено в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан auth или присутствуют переменные среды OpenStack OS_* . Если cloud — словарь, он содержит полную конфигурацию облака, как в разделе clouds.yaml. | |
| dns_nameservers | Список DNS-серверов для этой подсети. | |
| enable_dhcp bool |
| Включить DHCP для этой подсети. |
| gateway_ip | IP-адрес, который будет назначен шлюзу для этой подсети | |
| host_routes | Список словарей маршрутов хоста для подсети. | |
| interface (добавлено в 2.3) |
| Тип URL конечной точки для извлечения из каталога сервисов. псевдонимы: endpoint_type |
| ip_version | Значение по умолчанию: 4 | Версия IP-адреса подсети 4 или 6 |
| ipv6_address_mode |
| Режим адресации IPv6 |
| ipv6_ra_mode |
| Режим маршрутизации объявлений IPv6 |
| key | Путь к ключу клиента для использования в ходе транзакции SSL. | |
| name обязательно | Имя подсети, которое должно быть создано. Хотя Neutron допускает имена подсетей, не являющиеся уникальными, этот модуль требует уникальности имен подсетей. | |
| network_name | Имя сети, к которой должна быть подключена подсеть Требуется, когда state равно 'present' | |
| no_gateway_ip bool (добавлено в 2.2) |
| IP-адрес шлюза не будет назначен для этой подсети |
| project (добавлено в 2.1) | Имя или идентификатор проекта, содержащий подсеть (только для администраторов) | |
| region_name | Имя региона. | |
| state |
| Указывает желаемое состояние ресурса |
| timeout | Значение по умолчанию: 180 | Время ожидания Ansible для запрошенного ресурса. |
| use_default_subnetpool bool |
| Использовать пул подсетей по умолчанию для ip_version для получения CIDR. |
| verify bool |
| Проверка запросов API SSL. До версии 2.3 по умолчанию было True. псевдонимы: validate_certs |
| wait bool |
| Должен ли Ansible ждать завершения запрошенного ресурса. |
Примечания
Примечание
- Стандартные переменные среды OpenStack, такие как
OS_USERNAME, могут использоваться вместо явных значений. - Информация об авторизации управляется os-client-config, что означает, что значения могут поступать из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных среды, и наконец, из явных параметров в playbooks. Более подробную информацию можно найти на странице http://docs.openstack.org/developer/os-client-config
Примеры
# 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
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратно совместимый.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в Поддержка и техническое обслуживание модулей.
Список других модулей, которые также поддерживаются сообществом Ansible, см. здесь.
Автор
- Monty Taylor (@emonty)
Подсказка
Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/os_subnet_module.html
