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 доступен только при разрешении public-read для объекта.
force логический	Варианты: нет да ←	Принудительно перезаписывает локальный файл на файловой системе или удаленно объект/ключ. Используется с операциями 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	Варианты: нет да	Включена или выключена версия (обратите внимание, что после включения версионирования ее можно только приостановить)

Примеры

- 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. [сообщество]

Авторы

Benno Joy (@bennojoy)
Lukas Beumer (@nitaco)

Подсказка

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

© 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/gc_storage_module.html