openstack.cloud.os_object – Создание или удаление объектов и контейнеров из OpenStack

Примечание

Этот плагин является частью коллекции openstack.cloud (версия 1.2.1).

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

Для использования в книге задач укажите: openstack.cloud.os_object.

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

Описание

Создание или удаление объектов и контейнеров из OpenStack

Требования

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

openstacksdk
openstacksdk >= 0.12.0
python >= 3.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_timeout целое число		Сколько времени (в секундах) должно ждать сокетное соединение перед истечением времени ожидания для вызовов API. Если этот параметр опущен, в библиотеку запросов ничего не будет передано.
auth словарь		Словарь, содержащий информацию об аутентификации, необходимую для стратегии подключения к облаку. Для плагина password по умолчанию это будет включать auth_url, username, password, project_name и любую информацию о доменах (например, user_domain_name или project_domain_name), если облако их поддерживает. Для других плагинов этот параметр должен содержать необходимые параметры плагина аутентификации. Этот параметр не нужен, если указано имя облака или присутствуют переменные окружения OpenStack OS_*.
auth_type строка		Имя плагина аутентификации для использования. Если облако использует что-то кроме парольной аутентификации, имя плагина должно быть указано здесь, и содержимое параметра auth должно быть соответствующим образом обновлено.
availability_zone строка		Игнорируется. Присутствует для обратной совместимости.
ca_cert строка		Путь к пакету сертификатов CA, который может использоваться для проверки SSL-запросов API. псевдонимы: cacert
client_cert строка		Путь к клиенту сертификату для использования в рамках SSL-транзакции. псевдонимы: cert
client_key строка		Путь к ключу клиента для использования в рамках SSL-транзакции. псевдонимы: key
cloud сырые данные		Именованное облако или конфигурация облака для работы. Если cloud является строкой, она ссылается на именованную конфигурацию облака, как определено в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан auth или присутствуют переменные окружения OpenStack OS_. Если cloud* является словарем, он содержит полную конфигурацию облака, как в разделе clouds.yaml.
container строка / обязательно		Имя контейнера, в котором нужно создать объект
container_access строка	Варианты: private ← public	желаемый уровень доступа к контейнеру.
filename строка		Путь к локальному файлу, который должен быть загружен.
interface строка	Варианты: admin internal public ←	Тип URL-адреса конечной точки для извлечения из каталога сервисов. псевдонимы: endpoint_type
name строка		Имя, которое нужно присвоить объекту. Если опущено, операции будут выполняться над всем контейнером
region_name строка		Имя региона.
state строка	Варианты: present ← absent	Ресурс должен присутствовать или отсутствовать.
timeout целое число	По умолчанию: 180	Сколько времени Ansible должно ждать запрошенного ресурса.
validate_certs булево	Варианты: no ← yes	Нужно ли проверять SSL-запросы API. До Ansible 2.3 это было установлено по умолчанию на `yes`. псевдонимы: verify
wait булево	Варианты: no yes ←	Ansible должен ждать, пока запрошенный ресурс не будет завершен.

Примечания

Примечание

Можно использовать стандартные переменные окружения OpenStack, такие как OS_USERNAME, вместо явного указания значений.
Информация об аутентификации управляется openstacksdk, что означает, что значения могут поступать из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных окружения, и, наконец, из явных параметров в задачах. Дополнительную информацию можно найти по адресу https://docs.openstack.org/openstacksdk/

Примеры

- name: "Create a object named 'fstab' in the 'config' container"
  openstack.cloud.object:
    cloud: mordred
    state: present
    name: fstab
    container: config
    filename: /etc/fstab

- name: Delete a container called config and all of its contents
  openstack.cloud.object:
    cloud: rax-iad
    state: absent
    container: config

Авторы

OpenStack Ansible SIG

© 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/openstack/cloud/os_object_module.html