os_floating_ip - Добавление/удаление виртуального IP-адреса с экземпляра
Новое в версии 2.0.
Обзор
- Добавить или удалить виртуальный IP-адрес для экземпляра
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.7
- shade
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| 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) | По умолчанию: None | Имя или идентификатор частной сети neutron, в которой находится статический IP-адрес для подключения виртуального IP-адреса. псевдонимы: fixed_network, internal_network |
| network | Имя или идентификатор внешней сети neutron или имя пула nova. | |
| purge (добавлено в 2.1) | По умолчанию: нет | Когда state отсутствует, указывает, следует ли полностью удалить виртуальный IP-адрес или только отсоединить его от сервера. По умолчанию выполняется только отсоединение. |
| region_name | Имя региона. | |
| reuse | По умолчанию: нет | Когда state присутствует, а floating_ip_address отсутствует, этот параметр можно использовать для указания, следует ли пытаться повторно использовать виртуальный IP-адрес, уже выделенный проекту. |
| server требуется | Имя или идентификатор экземпляра, которому должен быть назначен IP-адрес. | |
| state |
| Ресурс должен быть присутствовать или отсутствовать. |
| timeout | По умолчанию: 60 | Время ожидания появления прикрепленного IP-адреса. См. wait. |
| verify |
| Следует ли проверять запросы API SSL. До версии 2.3 по умолчанию было True. псевдонимы: validate_certs |
| wait |
| При подключении виртуального 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
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость.
Автор
- 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.5/modules/os_floating_ip_module.html
