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

Параметры

параметр	обязательно	варианты	комментарии
адрес	нет		IPv4 или имя IP-адреса. Должен быть того же уровня (региональный, глобальный). Зарезервированные адреса можно (и, вероятно, следует) использовать для глобальных правил переадресации. Вы можете резервировать IP-адреса из консоли или с помощью модуля gce_eip.
имя_правила_переадресации	да		Имя правила переадресации.
диапазон_портов	нет		Для глобальных правил переадресации, значение должно быть установлено на 80 или 8080 для TargetHttpProxy и 443 для TargetHttpsProxy или TargetSslProxy.
протокол	нет		Для глобальных правил переадресации, TCP, UDP, ESP, AH, SCTP или ICMP. По умолчанию - TCP.
регион	нет		Регион для этого правила переадресации. В настоящее время поддерживается только «global».
состояние	да	present absent	Состояние правила переадресации. 'present' или 'absent'
цель	нет		Ресурс-цель для правила переадресации. Для глобального прокси это глобальный ресурс TargetProxy. Требуется для внешнего балансирования нагрузки (включая глобальное балансирование нагрузки)

Примеры

- 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

Возвращаемые значения

Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие являются полями, уникальными для данного модуля:

название	описание	возвращается	тип	пример
правило_переадресации	Словарь GCP правила переадресации	Всегда. Обратитесь к документации GCP для подробного описания полей.	dict	{'имя': 'my-forwarding_rule', 'цель': '...'}
имя_правила_переадресации	Имя правила переадресации	Всегда	str	my-target-proxy
регион	Регион для правила переадресации.	Всегда	bool	True
состояние	состояние правила переадресации	Всегда.	str	present

Примечания

Примечание

В настоящее время поддерживаются только глобальные правила переадресации. Таким образом, схема балансировки нагрузки всегда EXTERNAL.

Статус

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

Для получения помощи в разработке модулей, если вы заинтересованы, пожалуйста, прочитайте Информацию о сообществе и участие в разработке, Тестирование 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/gcp_forwarding_rule_module.html