rax_files - Управление контейнерами Rackspace Cloud Files

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

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

Обзор

Управление контейнерами Rackspace Cloud Files

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

python >= 2.6
pyrax

Параметры

параметр	обязательно	по умолчанию	значения	комментарии
api_key	нет			Ключ API Rackspace, переопределяет credentials. псевдонимы: password
clear_meta	нет	нет	да нет	Необязательно очистить существующие метаданные при применении метаданных к существующим контейнерам. Выбор этого параметра уместен только при установке type=meta
container	да			Контейнер для операций с контейнерами или метаданными.
credentials	нет			Файл с учетными данными Rackspace. Игнорируется, если указаны api_key и username. псевдонимы: creds_file
env (добавлен в 1.5)	нет			Среда, как настроено в ~/.pyrax.cfg, см. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration.
meta	нет			Словарь значений метаданных для контейнера.
private	нет			Устанавливает контейнер как частный, удаляя его из CDN. Внимание! Частные контейнеры, если ранее были публичными, могут иметь доступные объекты до истечения TTL кэшированных объектов.
public	нет			Устанавливает контейнер как публичный, доступный через Cloud Files CDN.
region	нет	DFW		Регион для создания экземпляра.
state	нет	present	present absent	Указывает желаемое состояние ресурса.
ttl	нет			В секундах, устанавливает глобальное TTL для всех объектов, кэшированных на узлах CDN. Установка TTL уместна только для публичных контейнеров.
type	нет	file	file meta	Тип объекта для работы, например, объект метаданных или объект контейнера.
username	нет			Имя пользователя Rackspace, переопределяет credentials.
verify_ssl (добавлен в 1.5)	нет			Требовать ли проверку SSL API-подключений.
web_error	нет			Устанавливает объект для отображения страницы HTTP-ошибки при доступе по CDN-URL.
web_index	нет			Устанавливает объект для отображения страницы HTTP-индекса при доступе по CDN-URL.

Примеры

- name: "Test Cloud Files Containers"
  hosts: local
  gather_facts: no
  tasks:
    - name: "List all containers"
      rax_files:
        state: list

    - name: "Create container called 'mycontainer'"
      rax_files:
        container: mycontainer

    - name: "Create container 'mycontainer2' with metadata"
      rax_files:
        container: mycontainer2
        meta:
          key: value
          file_for: someuser@example.com

    - name: "Set a container's web index page"
      rax_files:
        container: mycontainer
        web_index: index.html

    - name: "Set a container's web error page"
      rax_files:
        container: mycontainer
        web_error: error.html

    - name: "Make container public"
      rax_files:
        container: mycontainer
        public: yes

    - name: "Make container public with a 24 hour TTL"
      rax_files:
        container: mycontainer
        public: yes
        ttl: 86400

    - name: "Make container private"
      rax_files:
        container: mycontainer
        private: yes

- name: "Test Cloud Files Containers Metadata Storage"
  hosts: local
  gather_facts: no
  tasks:
    - name: "Get mycontainer2 metadata"
      rax_files:
        container: mycontainer2
        type: meta

    - name: "Set mycontainer2 metadata"
      rax_files:
        container: mycontainer2
        type: meta
        meta:
          uploaded_by: someuser@example.com

    - name: "Remove mycontainer2 metadata"
      rax_files:
        container: "mycontainer2"
        type: meta
        state: absent
        meta:
          key: ""
          file_for: ""

Примечания

Примечание

Можно использовать следующие переменные среды: RAX_USERNAME, RAX_API_KEY, RAX_CREDS_FILE, RAX_CREDENTIALS, RAX_REGION.
RAX_CREDENTIALS и RAX_CREDS_FILE указывают на файл с учетными данными для pyrax. См. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#authenticating
RAX_USERNAME и RAX_API_KEY позволяют обойти использование файла с учетными данными.
RAX_REGION определяет регион Rackspace Public Cloud (DFW, ORD, LON, ...)

Статус

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

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