os_floating_ip – Добавление/удаление плавающего IP-адреса на экземпляр
Новая версия 2.0.
Обзор
- Добавление или удаление плавающего IP-адреса к экземпляру
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- openstacksdk
- python >= 2.7
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_timeout - | Время ожидания сокета при таймауте вызовов API. Если этот параметр опущен, ничего не передается в библиотеку запросов. | |
| auth - | Словарь, содержащий информацию об авторизации, необходимую стратегии плагина авторизации облака. Для плагина password по умолчанию он будет содержать auth_url, username, password, project_name и любую информацию о домене, если облако её поддерживает. Для других плагинов этот параметр должен содержать необходимые параметры плагина авторизации. Этот параметр не требуется, если указано имя облака или присутствуют переменные окружения OpenStack OS_*. | |
| auth_type - | Имя плагина авторизации для использования. Если облако использует что-то, кроме парольной аутентификации, имя плагина должно быть указано здесь, а содержимое параметра auth должно быть соответствующим образом обновлено. | |
| availability_zone - | Игнорируется. Присутствует для обратной совместимости | |
| cacert - | Путь к пакету сертификатов CA, который можно использовать для проверки запросов SSL API. | |
| cert - | Путь к клиенту сертификату для использования в рамках SSL-транзакции. | |
| cloud - | Используемое облако или конфигурация облака. Если cloud — строка, она ссылается на конфигурацию облака, как определено в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не требуется, если указан auth или присутствуют переменные окружения OpenStack OS_* . Если cloud — словарь, он содержит полную конфигурацию облака, как в разделе clouds.yaml. | |
| fixed_address - | К какому фиксированному IP-адресу сервера должен быть прикреплён плавающий IP-адрес. | |
| floating_ip_address - | Плавающий IP-адрес для присоединения или отсоединения. Требуется только если state отсутствует. При наличии state может использоваться для указания IP-адреса для подключения. | |
| interface - добавлено в 2.3 |
| Тип URL конечной точки для извлечения из каталога служб. псевдонимы: endpoint_type |
| key - | Путь к ключу клиента для использования в рамках SSL-транзакции. | |
| nat_destination - добавлено в 2.3 | Имя или идентификатор частной сети neutron, в которой находится фиксированный IP-адрес для подключения плавающего IP-адреса. псевдонимы: fixed_network, internal_network | |
| network - | Имя или идентификатор внешней сети neutron или имя пула nova. | |
| purge boolean добавлено в 2.1 |
| Когда state отсутствует, указывает, нужно ли полностью удалить плавающий IP-адрес или только отсоединить его от сервера. По умолчанию отсоединяется только. |
| region_name - | Имя региона. | |
| reuse boolean |
| Когда state присутствует, а floating_ip_address отсутствует, этот параметр может использоваться для указания, следует ли пытаться повторно использовать плавающий IP-адрес, уже выделенный проекту. |
| server - / обязательно | Имя или идентификатор экземпляра, которому должен быть назначен IP-адрес. | |
| state - |
| Ресурс должен быть присутствующим или отсутствующим. |
| timeout - | По умолчанию: 60 | Время ожидания появления прикрепленного IP-адреса. См. wait. |
| verify boolean |
| Нужно ли проверять запросы SSL API. До версии 2.3 по умолчанию было True. псевдонимы: validate_certs |
| wait boolean |
| При присвоении плавающего IP-адреса, укажите, нужно ли ждать его подключения. |
Примечания
Примечание
- Могут использоваться стандартные переменные окружения 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
Примеры
# Assign a floating IP to the fist interface of `cattle001` from an exiting
# external network or nova pool. A new floating IP from the first available
# external network is allocated to the project.
- os_floating_ip:
cloud: dguerri
server: cattle001
# Assign a new floating IP to the instance fixed ip `192.0.2.3` of
# `cattle001`. If a free floating IP is already allocated to the project, it is
# reused; if not, a new one is created.
- os_floating_ip:
cloud: dguerri
state: present
reuse: yes
server: cattle001
network: ext_net
fixed_address: 192.0.2.3
wait: true
timeout: 180
# Assign a new floating IP from the network `ext_net` to the instance fixed
# ip in network `private_net` of `cattle001`.
- os_floating_ip:
cloud: dguerri
state: present
server: cattle001
network: ext_net
nat_destination: private_net
wait: true
timeout: 180
# Detach a floating IP address from a server
- os_floating_ip:
cloud: dguerri
state: absent
floating_ip_address: 203.0.113.2
server: cattle001
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Davide Guerri <davide.guerri@hp.com>
Подсказка
Если вы заметили какие-либо проблемы в этом руководстве, вы можете изменить этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/os_floating_ip_module.html
