gcp_forwarding_rule - Создание, обновление или удаление правила перенаправления.
Новая версия 2.4.
Обзор
- Создание, обновление или удаление правила перенаправления. См. https://cloud.google.com/compute/docs/load-balancing/http/target-proxies для обзора. Более подробную информацию об API глобальных правил перенаправления можно найти по адресу https://cloud.google.com/compute/docs/reference/latest/globalForwardingRules. Более подробную информацию об API правил перенаправления можно найти по адресу https://cloud.google.com/compute/docs/reference/latest/forwardingRules
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- google-api-python-client >= 1.6.2
- google-auth >= 0.9.0
- google-auth-httplib2 >= 0.0.2
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| address | IPv4 или имя IP-адреса. Должен быть того же уровня (региональный, глобальный). Зарезервированные адреса могут (и, вероятно, должны) использоваться для глобальных правил перенаправления. Вы можете резервировать IP-адреса из консоли или с помощью модуля gce_eip. | |
| forwarding_rule_name обязательно | Имя правила перенаправления. | |
| port_range | Для глобальных правил перенаправления значение должно быть установлено на 80 или 8080 для TargetHttpProxy и 443 для TargetHttpsProxy или TargetSslProxy. | |
| protocol | Для глобальных правил перенаправления TCP, UDP, ESP, AH, SCTP или ICMP. Значение по умолчанию — TCP. | |
| region | Регион для этого правила перенаправления. В настоящее время поддерживается только «global». | |
| state обязательно |
| Состояние правила перенаправления. «present» или «absent» |
| target | Ресурс-цель для правила перенаправления. Для глобального прокси это глобальный ресурс TargetProxy. Требуется для внешнего балансирования нагрузки (включая глобальное балансирование). |
Примечания
Примечание
- В настоящее время поддерживаются только глобальные правила перенаправления. Таким образом, схема балансировки нагрузки всегда EXTERNAL.
Примеры
- name: Create Minimum GLOBAL Forwarding_Rule
gcp_forwarding_rule:
service_account_email: "{{ service_account_email }}"
credentials_file: "{{ credentials_file }}"
project_id: "{{ project_id }}"
forwarding_rule_name: my-forwarding_rule
protocol: TCP
port_range: 80
region: global
target: my-target-proxy
state: present
- name: Create Forwarding_Rule w/reserved static address
gcp_forwarding_rule:
service_account_email: "{{ service_account_email }}"
credentials_file: "{{ credentials_file }}"
project_id: "{{ project_id }}"
forwarding_rule_name: my-forwarding_rule
protocol: TCP
port_range: 80
address: my-reserved-static-address-name
region: global
target: my-target-proxy
state: present
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие — поля, уникальные для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| forwarding_rule dict | Всегда. Обратитесь к документации GCP для подробного описания полей. | Словарь GCP Forwarding_Rule Пример: {'name': 'my-forwarding_rule', 'target': '...'} |
| forwarding_rule_name str | Всегда | Имя правила перенаправления Пример: my-target-proxy |
| region bool | Всегда | Регион для правила перенаправления. Пример: True |
| state str | Всегда. | Состояние правила перенаправления Пример: present |
Статус
Этот модуль помечен как preview, что означает, что его интерфейс не гарантирует обратной совместимости.
Техническое обслуживание
Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- Tom Melendez (@supertom) <tom@supertom.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.6/modules/gcp_forwarding_rule_module.html
