gcp_forwarding_rule – Создание, обновление или удаление правила маршрутизации

Новая в версии 2.4.

УСТАРЕВШЕ
Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

УСТАРЕВШЕ

Удалено в Ansible:
	версия: 2.12
Почему:	Выпущены обновленные модули с повышенной функциональностью
Альтернатива:	Используйте gcp_compute_forwarding_rule или gcp_compute_global_forwarding_rule вместо этого.

Обзор

Создание, обновление или удаление правила маршрутизации. См. 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	Состояние правила маршрутизации. '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 словарь	Всегда. Обратитесь к документации GCP для подробных описаний полей.	Словарь GCP Forwarding_Rule Пример: {'name': 'my-forwarding_rule', 'target': '...'}
forwarding_rule_name строка	Всегда	Имя правила маршрутизации Пример: my-target-proxy
region логическое	Всегда	Регион для правила маршрутизации. Пример: True
state строка	Всегда.	Состояние правила маршрутизации Пример: present

Статус

Этот модуль будет удален в версии 2.12. [устаревший]
Для получения дополнительной информации см. УСТАРЕВШЕ.

Авторы

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.9/modules/gcp_forwarding_rule_module.html