Spec-Zone.ru › Ansible 2.7

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
- / обязательно
    Варианты:
  • machineaccount
  • serviceaccount
  • application
Тип используемых учетных данных.
bucket_name
- / обязательно
Имя хранилища Cloud Storage.
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
-
По умолчанию:
null
Проект Google Cloud Platform для использования.
scopes
-
Массив используемых областей.
service_account_email
-
Необязательный адрес электронной почты учетной записи службы, если выбран machineaccount и пользователь не хочет использовать адрес электронной почты по умолчанию.
service_account_file
-
Путь к файлу JSON учетной записи службы, если в качестве типа выбрано serviceaccount.
state
-
    Варианты:
  • present ←
  • absent
Указывает, должен ли данный объект существовать в GCP.

Примечания

Примечание

  • Справочная информация по API: https://cloud.google.com/compute/docs/reference/latest/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.
  • Для аутентификации можно установить 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: "service_account"
      service_account_file: "/tmp/auth.pem"
      state: present

Значения возврата

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

Ключ Возвращаемое значение Описание
bucket_name
строка
успех
Имя хранилища Cloud Storage.

creation_timestamp
строка
успех
Дата и время создания в формате RFC3339.

description
строка
успех
Необязательное текстовое описание ресурса, предоставляемое клиентом при создании ресурса.

enable_cdn
boolean
успех
Если true, включить Cloud CDN для данного BackendBucket.

id
целое число
успех
Уникальный идентификатор ресурса.

name
строка
успех
Имя ресурса. Предоставляется клиентом при создании ресурса. Имя должно иметь длину от 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.7/modules/gcp_compute_backend_bucket_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API