gc_storage - Этот модуль управляет объектами/бакетами в Google Cloud Storage.

Новый в версии 1.4.

Обзор
Требования (к хосту, на котором выполняется модуль)
Параметры
Примеры
- Статус

Обзор

Этот модуль позволяет пользователям управлять своими объектами/бакетами в Google Cloud Storage. Он позволяет выполнять операции загрузки и скачивания, а также устанавливать некоторые предопределённые разрешения. Он также позволяет извлекать URL-адреса объектов для использования в плейбуках и извлекать строковое содержимое объектов. Данному модулю необходимо задать проект по умолчанию в GCS до использования плейбука. Смотрите https://developers.google.com/storage/docs/reference/v1/apiversion1 для получения информации о настройке проекта по умолчанию.

Требования (к хосту, на котором выполняется модуль)

python >= 2.6
boto >= 2.9

Параметры

параметр	обязательно	по умолчанию	значения	комментарии
bucket	да			Имя бакета.
dest	нет			Путь к файлу назначения при скачивании объекта/ключа с помощью операции GET.
expiration	нет			Срок действия (в секундах) URL-адреса, сгенерированного и возвращённого GCA при выполнении операции mode=put или mode=get_url. Этот URL доступен только при acl объекта public-read.
force	нет	True		Принудительно перезаписывает либо локальный файл на файловой системе, либо удалённый объект/ключ. Используется с операциями PUT и GET. псевдонимы: overwrite
gs_access_key	да			Ключ доступа GS. Если не задан, используется значение переменной окружения GS_ACCESS_KEY_ID.
gs_secret_key	да			Секретный ключ GS. Если не задан, используется значение переменной окружения GS_SECRET_ACCESS_KEY.
headers (добавлено в 2.0)	нет	{}		Заголовки, добавляемые к объекту.
mode	да		get put get_url get_str delete create	Переключает поведение модуля между загрузкой, скачиванием, получением URL (возвращение URL для скачивания), скачиванием объекта как строки, созданием (бакета) и удалением (бакета).
object	нет			Имя ключа объекта внутри бакета. Также может использоваться для создания «виртуальных каталогов» (см. примеры).
permission	нет	private		Этот параметр позволяет пользователю устанавливать предопределённые разрешения на создаваемый объект/бак. Доступные разрешения: 'private', 'public-read', 'authenticated-read'.
region (добавлено в 2.4)	нет	US		Регион gs для использования. Если не определён, используется значение 'US'. См. https://cloud.google.com/storage/docs/bucket-locations
src	нет			Путь к исходному файлу при выполнении операции PUT.
versioning (добавлено в 2.4)	нет		yes no	Включено или выключено управление версиями (обратите внимание, что после включения управления версиями, его можно только приостановить)

Примеры

- name: Upload some content
  gc_storage:
    bucket: mybucket
    object: key.txt
    src: /usr/local/myfile.txt
    mode: put
    permission: public-read

- name: Upload some headers
  gc_storage:
    bucket: mybucket
    object: key.txt
    src: /usr/local/myfile.txt
    headers: '{"Content-Encoding": "gzip"}'

- name: Download some content
  gc_storage:
    bucket: mybucket
    object: key.txt
    dest: /usr/local/myfile.txt
    mode: get

- name: Download an object as a string to use else where in your playbook
  gc_storage:
    bucket: mybucket
    object: key.txt
    mode: get_str

- name: Create an empty bucket
  gc_storage:
    bucket: mybucket
    mode: create

- name: Create a bucket with key as directory
  gc_storage:
    bucket: mybucket
    object: /my/directory/path
    mode: create

- name: Delete a bucket and all contents
  gc_storage:
    bucket: mybucket
    mode: delete

- name: Create a bucket with versioning enabled
  gc_storage:
    bucket: "mybucket"
    versioning: yes
    mode: create

- name: Create a bucket located in the eu
  gc_storage:
    bucket: "mybucket"
    region: "europe-west3"
    mode: create

Статус

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

Для получения помощи в разработке модулей, если вам это интересно, пожалуйста, прочитайте Информацию о сообществе и участии в разработке, Тестирование 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/gc_storage_module.html