community.general.rax_files – Управление контейнерами Rackspace Cloud Files

Примечание

Этот плагин входит в коллекцию community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в плейбуке укажите: community.general.rax_files.

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

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

Требования

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

pyrax
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key строка		Ключ API Rackspace, переопределяет credentials. псевдонимы: password
auth_endpoint строка		URI службы аутентификации. Если не указано, будет установлено значение https://identity.api.rackspacecloud.com/v2.0/
clear_meta логическое	Варианты: нет ← да	Необязательно очистить существующие метаданные при применении метаданных к существующим контейнерам. Выбор этого параметра уместен только при установке type=meta
container строка		Контейнер для работы с контейнерами или метаданными.
credentials путь		Файл, в котором хранятся учетные данные Rackspace. Игнорируется, если указаны api_key и username. псевдонимы: creds_file
env строка		Среда, как настроена в ~/.pyrax.cfg, см. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration.
identity_type строка	По умолчанию: "rackspace"	Механизм аутентификации, например, rackspace или keystone.
meta словарь		Словарь значений для установки в качестве метаданных контейнера
private логическое	Варианты: нет ← да	Используется для установки контейнера как приватного, удаляя его из CDN. Предупреждение! Приватные контейнеры, если ранее были сделаны публичными, могут иметь доступные объекты до истечения срока действия кэшированных объектов
public логическое	Варианты: нет ← да	Используется для установки контейнера как публичного, доступного через CDN Cloud Files
region строка		Регион для создания экземпляра
state строка	Варианты: present ← absent list	Указывает желаемое состояние ресурса
tenant_id строка		Идентификатор арендатора для аутентификации.
tenant_name строка		Имя арендатора для аутентификации.
ttl целое число		В секундах, устанавливает срок действия (TTL) для всех объектов в контейнере, кэшированных на узлах CDN. Установка TTL допустима только для публичных контейнеров
type строка	Варианты: container ← meta	Тип объекта для работы, например, объект метаданных или объект контейнера
username строка		Имя пользователя Rackspace, переопределяет credentials.
validate_certs логическое	Варианты: нет да	Требовать ли проверку SSL API-точек доступа. псевдонимы: verify_ssl
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"
      community.general.rax_files:
        state: list

    - name: "Create container called 'mycontainer'"
      community.general.rax_files:
        container: mycontainer

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

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

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

    - name: "Make container public"
      community.general.rax_files:
        container: mycontainer
        public: yes

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

    - name: "Make container private"
      community.general.rax_files:
        container: mycontainer
        private: yes

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

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

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

Авторы

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.10/collections/community/general/rax_files_module.html