Spec-Zone.ru › Ansible 2.8

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API