google.cloud.gcp_compute_backend_bucket – Создаёт GCP BackendBucket

Примечание

Этот плагин входит в коллекцию google.cloud (версия 1.0.2).

Для его установки используйте: ansible-galaxy collection install google.cloud.

Для использования в плейбуке укажите: google.cloud.gcp_compute_backend_bucket.

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

Обзор

Ведра обратного подключения позволяют использовать ведра 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 словарь			Настройка Cloud CDN для этого ведра обратного подключения.
	signed_url_cache_max_age_sec целое число		Максимальное количество секунд, в течение которого ответ на запрос к подписанному URL-адресу будет считаться свежим. По истечении этого периода ответ будет повторно проверен перед предоставлением. При предоставлении ответов на запросы к подписанным URL-адресам Cloud CDN будет внутренне вести себя так, как будто все ответы от этого обратного подключения содержат заголовок «Cache-Control: public, max-age=[TTL]», независимо от наличия существующего заголовка Cache-Control. Фактические заголовки, предоставляемые в ответах, не будут изменены.
description строка			Необязательное текстовое описание ресурса, предоставляемое клиентом при создании ресурса.
enable_cdn логическое значение		Варианты: no yes	Если true, Cloud CDN включен для этого BackendBucket.
env_type строка			Указывает, в какой среде Ansible вы выполняете этот модуль. Это не следует устанавливать, если вы не знаете, что делаете. Это изменяет только строку User Agent для всех запросов к API.
name строка / обязательно			Имя ресурса. Предоставляется клиентом при создании ресурса. Длина имени должна составлять от 1 до 63 символов и соответствовать RFC1035. То есть, длина имени должна быть от 1 до 63 символов и соответствовать регулярному выражению `[a-z]([-a-z0-9]*[a-z0-9])?`, что означает, что первый символ должен быть строчной буквой, а все последующие символы должны быть тире, строчной буквой или цифрой, за исключением последнего символа, который не может быть тире.
project строка			Проект Google Cloud Platform, который нужно использовать.
scopes список / элементы=строка			Массив используемых областей.
service_account_contents jsonarg			Содержимое файла 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_contents, используя переменную среды GCP_SERVICE_ACCOUNT_CONTENTS.
для аутентификации можно установить service_account_email, используя переменную среды GCP_SERVICE_ACCOUNT_EMAIL.
для аутентификации можно установить auth_kind, используя переменную среды GCP_AUTH_KIND.
для аутентификации можно установить scopes, используя переменную среды GCP_SCOPES.
Значения переменных среды будут использоваться только в том случае, если значения в плейбуке не заданы.
Параметры service_account_email и service_account_file взаимоисключающие.

Примеры

- name: create a bucket
  google.cloud.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
  google.cloud.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 строка		успех	Имя ведра Cloud Storage.
cdnPolicy сложное		успех	Настройка Cloud CDN для этого ведра обратного подключения.
	signedUrlCacheMaxAgeSec целое число	успех	Максимальное количество секунд, в течение которого ответ на запрос к подписанному URL-адресу будет считаться свежим. По истечении этого периода ответ будет повторно проверен перед предоставлением. При предоставлении ответов на запросы к подписанным URL-адресам Cloud CDN будет внутренне вести себя так, как будто все ответы от этого обратного подключения содержат заголовок «Cache-Control: public, max-age=[TTL]», независимо от наличия существующего заголовка Cache-Control. Фактические заголовки, предоставляемые в ответах, не будут изменены.
creationTimestamp строка		успех	Дата и время создания в формате RFC3339.
description строка		успех	Необязательное текстовое описание ресурса, предоставляемое клиентом при создании ресурса.
enableCdn логическое значение		успех	Если true, Cloud CDN включен для этого BackendBucket.
id целое число		успех	Уникальный идентификатор ресурса.
name строка		успех	Имя ресурса. Предоставляется клиентом при создании ресурса. Длина имени должна составлять от 1 до 63 символов и соответствовать RFC1035. То есть, длина имени должна быть от 1 до 63 символов и соответствовать регулярному выражению `[a-z]([-a-z0-9]*[a-z0-9])?`, что означает, что первый символ должен быть строчной буквой, а все последующие символы должны быть тире, строчной буквой или цифрой, за исключением последнего символа, который не может быть тире.

Авторы

Google Inc. (@googlecloudplatform)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/google/cloud/gcp_compute_backend_bucket_module.html