gcp_compute_backend_bucket – Создаёт GCP BackendBucket

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

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

Описание

Бэкенд-бакеты позволяют использовать ведра Google Cloud Storage с балансировкой нагрузки HTTP(S).
Балансировщик HTTP(S) может перенаправлять трафик на указанные URL-адреса в бэкенд-ведре, а не в бэкенд-сервис. Он может отправлять запросы на статический контент в ведро Cloud Storage и запросы на динамический контент в виртуальную машину.

Требования

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

python >= 2.6
requests >= 2.18.4
google-auth >= 1.3.0

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
auth_kind строка / обязательно		Варианты: application machineaccount serviceaccount	Тип используемых учетных данных.
bucket_name - / обязательно			Имя ведра Cloud Storage.
cdn_policy - добавлен в 2.8			Настройка Cloud CDN для этого бэкенд-ведра.
	signed_url_cache_max_age_sec -	По умолчанию: "3600"	Максимальное количество секунд, в течение которых ответ на запрос подписанного URL-адреса считается свежим. По умолчанию 1 час (3600 с). По истечении этого периода ответ будет повторно проверен перед отображением. При обработке ответов на запросы подписанных URL-адресов Cloud CDN будет внутренне вести себя так, как будто у всех ответов от этого бэкенда есть заголовок "Cache-Control: public, max-age=[TTL]", независимо от любого существующего заголовка Cache-Control. Фактические заголовки, отображаемые в ответах, не будут изменены.
description -			Необязательное текстовое описание ресурса, предоставленное клиентом при создании ресурса.
enable_cdn boolean		Варианты: no yes	Если значение true, включить Cloud CDN для этого BackendBucket.
name - / обязательно			Имя ресурса. Предоставляется клиентом при создании ресурса. Длина имени должна быть от 1 до 63 символов и соответствовать RFC1035. Точнее, длина имени должна быть от 1 до 63 символов и соответствовать регулярному выражению `[a-z]([-a-z0-9]*[a-z0-9])?`, что означает, что первый символ должен быть строчной буквой, а все последующие символы — дефисом, строчной буквой или цифрой, за исключением последнего символа, который не может быть дефисом.
project строка			Проект Google Cloud Platform, который нужно использовать.
scopes список			Массив используемых областей.
service_account_contents строка			Строка, представляющая содержимое файла JSON учетной записи службы. Это не должно передаваться как словарь, а строка, содержащая точное содержимое файла json учетной записи службы (корректный JSON).
service_account_email строка			Необязательный адрес электронной почты учетной записи службы, если выбран machineaccount, и пользователь не хочет использовать адрес по умолчанию.
service_account_file путь			Путь к файлу JSON учетной записи службы, если в качестве типа выбран serviceaccount.
state -		Варианты: present ← absent	Указывает, должен ли данный объект существовать в GCP.

Примечания

Примечание

Ссылка на API: https://cloud.google.com/compute/docs/reference/v1/backendBuckets
Использование ведра Cloud Storage в качестве бэкенда балансировщика нагрузки: https://cloud.google.com/compute/docs/load-balancing/http/backend-bucket
Для аутентификации можно задать service_account_file с помощью переменной среды GCP_SERVICE_ACCOUNT_FILE.
Для аутентификации можно задать service_account_email с помощью переменной среды GCP_SERVICE_ACCOUNT_EMAIL.
Для аутентификации можно задать service_account_contents с помощью переменной среды GCP_SERVICE_ACCOUNT_CONTENTS.
Для аутентификации можно задать auth_kind с помощью переменной среды GCP_AUTH_KIND.
Для аутентификации можно задать scopes с помощью переменной среды GCP_SCOPES.
Значения переменных среды будут использоваться только в том случае, если значения в playbook не заданы.
Параметры service_account_email и service_account_file взаимоисключающие.

Примеры

- name: create a bucket
  gcp_storage_bucket:
    name: bucket-backendbucket
    project: "{{ gcp_project }}"
    auth_kind: "{{ gcp_cred_kind }}"
    service_account_file: "{{ gcp_cred_file }}"
    state: present
  register: bucket

- name: create a backend bucket
  gcp_compute_backend_bucket:
    name: test_object
    bucket_name: "{{ bucket.name }}"
    description: A BackendBucket to connect LNB w/ Storage Bucket
    enable_cdn: 'true'
    project: test_project
    auth_kind: serviceaccount
    service_account_file: "/tmp/auth.pem"
    state: present

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

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

Ключ		Возвращаемое значение	Описание
bucketName строка		success	Имя ведра Cloud Storage.
cdnPolicy сложный		success	Настройка Cloud CDN для этого бэкенд-ведрa.
	signedUrlCacheMaxAgeSec целое число	success	Максимальное количество секунд, в течение которых ответ на запрос подписанного URL-адреса считается свежим. По умолчанию 1 час (3600 с). По истечении этого периода ответ будет повторно проверен перед отображением. При обработке ответов на запросы подписанных URL-адресов Cloud CDN будет внутренне вести себя так, как будто у всех ответов от этого бэкенда есть заголовок "Cache-Control: public, max-age=[TTL]", независимо от любого существующего заголовка Cache-Control. Фактические заголовки, отображаемые в ответах, не будут изменены.
creationTimestamp строка		success	Дата и время создания в формате RFC3339.
description строка		success	Необязательное текстовое описание ресурса, предоставленное клиентом при создании ресурса.
enableCdn логическое значение		success	Если true, включить Cloud CDN для этого BackendBucket.
id целое число		success	Уникальный идентификатор ресурса.
name строка		success	Имя ресурса. Предоставляется клиентом при создании ресурса. Длина имени должна быть от 1 до 63 символов и соответствовать RFC1035. Точнее, длина имени должна быть от 1 до 63 символов и соответствовать регулярному выражению `[a-z]([-a-z0-9]*[a-z0-9])?`, что означает, что первый символ должен быть строчной буквой, а все последующие символы — дефисом, строчной буквой или цифрой, за исключением последнего символа, который не может быть дефисом.

Статус

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

Авторы

Google Inc. (@googlecloudplatform)

Подсказка

Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

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