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. Содержит список хостов и соответствующий путь-матчер. Параметр 'hosts' — список шаблонов хостов для сопоставления. Они должны быть допустимыми именами хостов, за исключением , который будет соответствовать любой строке ([a-z0-9-.]). В этом случае * должен быть первым символом и должен быть после него либо - или .. Параметр 'path_matcher' — имя PathMatcher для использования для сопоставления пути части URL, если правило хоста соответствует хосту URL.
path_matchers -		Список именованных PathMatchers для использования с URL. Содержит правила путей, представляющие собой список путей и связанный с ними сервис. Также можно указать default_service для каждого path_matcher. Параметр 'name' — имя path_matcher, ссылающееся на него в host_rule. Параметр 'default_service' — имя ресурса BackendService. Он будет использоваться, если ни одно из правил пути, определенных этим 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 словарь	При указании.	Список правил хоста. Пример: [{'hosts': ['*.'], 'path_matcher': 'my-pm'}]
path_matchers словарь	При указании.	Список именованных PathMatchers для использования с URL. Пример: [{'name': 'my-pm', 'path_rules': [{'paths': ['/data']}], 'service': 'my-service'}]
state строка	Всегда.	Состояние Url_Map Пример: present
updated_url_map булево	если url_map был обновлен.	True, если url_map был обновлен. Не отображается при первоначальном создании url_map. Пример: True
url_map словарь	Всегда. Обратитесь к документации GCP для получения подробных описаний полей.	Словарь GCP Url_Map Пример: {'name': 'my-url-map', 'hostRules': ['...'], 'pathMatchers': ['...']}
url_map_name строка	Всегда	Имя Url_Map Пример: my-url-map

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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