gcp_url_map - Создание, обновление или удаление Url_Map.

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

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

Обзор

Создание, обновление или удаление Url_Map. См. https://cloud.google.com/compute/docs/load-balancing/http/url-map для обзора. Более подробная информация об API Url_Map доступна по адресу https://cloud.google.com/compute/docs/reference/latest/urlMaps#resource.

Требования

Ниже перечислены требования к хосту, на котором выполняется данный модуль.

python >= 2.6
google-api-python-client >= 1.6.2
google-auth >= 0.9.0
google-auth-httplib2 >= 0.0.2

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
default_service обязательно		Сервис по умолчанию для бэкенда, если не найдено совпадение с правилами хостов.
host_rules		Список правил хостов для использования с URL. Содержит список хостов и связанный path_matcher. Параметр 'hosts' представляет список шаблонов хостов для сопоставления. Они должны быть валидными именами хостов, за исключением , которое будет совпадать с любой строкой ([a-z0-9-.]). В этом случае * должен быть первым символом и должен быть после него либо - или .. Параметр 'path_matcher' — имя PathMatcher, используемого для сопоставления пути URL, если правило хоста соответствует хосту URL.
path_matchers		Список именованных PathMatcher для использования с URL. Содержит path_rules, которые представляют собой список путей и связанного сервиса. Также можно указать default_service для каждого path_matcher. Параметр 'name', по которому ссылается этот path_matcher в правиле хоста. Параметр 'default_service' — имя ресурса BackendService. Оно будет использоваться, если ни одно из path_rules, определённых этим path_matcher, не соответствует пути URL. Параметр 'path_rules' — список словарей, содержащих список путей и сервис, к которому нужно направить трафик. Каждый элемент пути должен начинаться с / и единственное место, где разрешено использование *, это в конце после /. Строка, переданная path_matcher, не включает текст после первого ? или
url_map_name обязательно		Имя Url_Map.

Примечания

Примечание

Поддерживаются только глобальные Backend Services.
В настоящее время не поддерживаются тесты Url_Map.

Примеры

- name: Create Minimal Url_Map
  gcp_url_map:
    service_account_email: "{{ service_account_email }}"
    credentials_file: "{{ credentials_file }}"
    project_id: "{{ project_id }}"
    url_map_name: my-url_map
    default_service: my-backend-service
    state: present
- name: Create UrlMap with pathmatcher
  gcp_url_map:
    service_account_email: "{{ service_account_email }}"
    credentials_file: "{{ credentials_file }}"
    project_id: "{{ project_id }}"
    url_map_name: my-url-map-pm
    default_service: default-backend-service
    path_matchers:
    - name: 'path-matcher-one'
      description: 'path matcher one'
      default_service: 'bes-pathmatcher-one-default'
      path_rules:
      - service: 'my-one-bes'
        paths:
        - '/data'
        - '/aboutus'
    host_rules:
      - hosts:
        - '*.'
        path_matcher: 'path-matcher-one'
    state: "present"

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

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

Ключ	Возвращаемое значение	Описание
host_rules словарь	Если указано.	Список правил хостов. Пример: [{'path_matcher': 'my-pm', 'hosts': ['*.']}]
path_matchers словарь	Если указано.	Список именованных PathMatcher для использования с URL. Пример: [{'name': 'my-pm', 'service': 'my-service', 'path_rules': [{'paths': ['/data']}]}]
state строка	Всегда.	Состояние Url_Map Пример: present
updated_url_map булево	если url_map был обновлён.	True, если url_map был обновлён. Не будет отображаться при первоначальном создании url_map. Пример: True
url_map словарь	Всегда. См. документацию GCP для подробного описания полей.	Словарь GCP Url_Map Пример: {'pathMatchers': ['...'], 'name': 'my-url-map', 'hostRules': ['...']}
url_map_name строка	Всегда	Имя Url_Map Пример: my-url-map

Статус

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

Автор

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.5/modules/gcp_url_map_module.html