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. Содержит правила пути, которые представляют собой список путей и связанный с ними сервис. Для каждого path_matcher также можно указать default_service. Параметр 'name' — идентификатор path_matcher, используемый правилом хоста. Параметр '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

Статус

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

Техническое обслуживание

Этот модуль помечен как community, что означает, что его поддерживает сообщество Ansible. Подробнее см. Техническое обслуживание и поддержка модулей.

Список других модулей, которые также поддерживаются сообществом Ansible, см. здесь.

Автор

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