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

Примечание

Этот плагин входит в коллекцию community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general

Для использования в плейбуке укажите: community.general.gcp_forwarding_rule

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

УСТЕРЕЛО

Удалено в: версии 2.0.0
Почему: Обновлённые модули выпущены с повышенной функциональностью
Альтернатива: Используйте google.cloud.gcp_compute_forwarding_rule или google.cloud.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.
credentials_file строка		Путь к JSON-файлу, связанному с электронным адресом учетной записи службы.
forwarding_rule_name строка / обязательно		Имя правила маршрутизации.
load_balancing_scheme строка	Варианты: EXTERNAL ←	Схема балансировки нагрузки. В настоящее время единственный выбор — EXTERNAL.
pem_file строка		Путь к PEM-файлу, связанному с электронным адресом учетной записи службы. Этот параметр устарел и может быть удален в будущих версиях. Используйте credentials_file вместо этого.
port_range строка		Для глобальных правил маршрутизации должно быть установлено значение 80 или 8080 для TargetHttpProxy и 443 для TargetHttpsProxy или TargetSslProxy.
project_id строка		Идентификатор проекта Google Cloud Platform.
protocol строка	Варианты: TCP ←	Для глобальных правил маршрутизации: TCP, UDP, ESP, AH, SCTP или ICMP. По умолчанию — TCP.
region строка / обязательно		Регион для данного правила маршрутизации. В настоящее время поддерживается только «global».
service_account_email строка		Электронный адрес учетной записи службы.
service_account_permissions список / элементы=строка		Разрешения учетной записи службы.
state строка / обязательно	Варианты: present absent	Состояние правила маршрутизации. 'present' или 'absent'
target строка		Ресурс назначения для правила маршрутизации. Для глобального прокси это глобальный ресурс TargetProxy. Требуется для внешней балансировки нагрузки (включая глобальную балансировку).

Примечания

Примечание

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

Примеры

- name: Create Minimum GLOBAL Forwarding_Rule
  community.general.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
  community.general.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.0.0. [устарел]
Для получения дополнительной информации см. УСТЕРЕЛО.

Авторы

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.10/collections/community/general/gcp_forwarding_rule_module.html