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

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

УСТЕРЕКШЕЕ
Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Состояние

УСТЕРЕКШЕЕ

Удалено в Ansible:
	версия: 2.12
Почему:	Обновлённые модули выпущены с повышенной функциональностью
Альтернатива:	Используйте gcp_compute_url_map вместо этого.

Обзор

Создание, обновление или удаление 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 -		Список HostRules для использования с URL. Содержит список хостов и связанный путь_сопоставитель. Параметр 'hosts' — это список шаблонов хостов для сопоставления. Они должны быть допустимыми именами хостов, за исключением , который будет соответствовать любой строке ([a-z0-9-.]). В этом случае * должен быть первым символом и должен следовать за ним в шаблоне либо - или .. Параметр 'path_matcher' — имя PathMatcher, используемое для сопоставления пути части URL, если HostRule соответствует части хоста URL.
path_matchers -		Список именованных PathMatchers для использования с URL. Содержит path_rules, которые представляют собой список путей и связанный сервис. Также можно указать default_service для каждого path_matcher. Параметр 'name' — это имя, по которому этот path_matcher ссылается на Host_rule. Параметр '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 словарь	Если указано.	Список HostRules. Пример: [{'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

Состояние

Этот модуль будет удалён в версии 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.9/modules/gcp_url_map_module.html