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

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

Обзор
- Требования
Параметры
Примечания
Примеры
Статус
Обслуживание
- Автор

Обзор

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

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

pyrax
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key		Ключ API Rackspace, переопределяет credentials. псевдонимы: password
auth_endpoint (добавлен в 1.5)	Значение по умолчанию: "https://identity.api.rackspacecloud.com/v2.0/"	URI службы аутентификации.
clear_meta bool	Варианты: нет ← да	При необходимости очистить существующие метаданные при применении метаданных к существующим контейнерам. Выбор этого варианта подходит только при установке 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.
identity_type (добавлен в 1.5)	Значение по умолчанию: "rackspace"	Использовать механизм аутентификации, например, rackspace или keystone.
meta		Словарь значений для установки в качестве метаданных контейнера
private		Устанавливает контейнер как закрытый, удаляя его из CDN. Внимание! Закрытые контейнеры, если ранее были публичными, могут иметь доступные объекты до истечения срока действия кэшированных объектов
public		Устанавливает контейнер как публичный, доступный через CDN Cloud Files.
region	Значение по умолчанию: "DFW"	Регион для создания экземпляра
state	Варианты: present ← absent	Указывает желаемое состояние ресурса
tenant_id (добавлен в 1.5)		Идентификатор арендатора, используемый для аутентификации.
tenant_name (добавлен в 1.5)		Имя арендатора, используемое для аутентификации.
ttl		В секундах, устанавливает срок действия для всех объектов в контейнере, кэшированных на узлах CDN. Установка срока действия применима только для публичных контейнеров
type	Варианты: file ← meta	Тип объекта для выполнения работы, т.е. объект метаданных или объект контейнера
username		Имя пользователя Rackspace, переопределяет credentials.
verify_ssl (добавлен в 1.5)		Требовать проверку SSL API-точек конечного входа.
web_error		Устанавливает объект, который будет представлен как страница HTTP-ошибки при обращении к URL-адресу CDN.
web_index		Устанавливает объект, который будет представлен как страница HTTP-индекса при обращении к URL-адресу CDN.

Примечания

Примечание

Можно использовать следующие переменные окружения: 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, …)
Можно использовать следующие переменные окружения: 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, …)

Примеры

- 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: ""

Статус

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

Обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Обслуживание и поддержка модулей для получения дополнительной информации.

Список других модулей, поддерживаемых сообществом Ansible, см. здесь.

Автор

Paul Durivage (@angstwad)

Подсказка

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

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/rax_files_module.html