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» |
| 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