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

Примечания

Примечание

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

Статус

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

Для получения помощи в разработке модулей, если вы это планируете, пожалуйста, ознакомьтесь с информацией и участием в сообществе, тестированием Ansible и разработкой модулей.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/gcp_url_map_module.html