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

Примечание

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

Для его установки используйте: 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. Предупреждение! Частные контейнеры, если ранее были сделаны общедоступными, могут иметь доступные объекты до истечения TTL кэшированных объектов
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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/rax_files_module.html