openstack.cloud.os_server_volume – Присоединение/отсоединение томов от виртуальных машин OpenStack

Примечание

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

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

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

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

Обзор

Присоединение или отсоединение томов от виртуальных машин 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, который может использоваться для проверки запросов API SSL. псевдонимы: cacert
client_cert строка		Путь к клиенту сертификату, который нужно использовать в рамках SSL-транзакции. псевдонимы: cert
client_key строка		Путь к ключу клиента, который нужно использовать в рамках SSL-транзакции. псевдонимы: key
cloud необработанные данные		Именованное облако или конфигурация облака для работы. Если cloud — строка, она ссылается на именованную конфигурацию облака, как определено в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан auth или присутствуют переменные окружения OpenStack OS_. Если cloud* — словарь, он содержит полную конфигурацию облака, как в разделе clouds.yaml.
device строка		Устройство, которое нужно присоединить. По умолчанию автоматически определяется имя устройства.
interface строка	Варианты: admin internal public ←	Тип URL конечной точки для извлечения из каталога услуг. псевдонимы: endpoint_type
region_name строка		Имя региона.
server строка / обязательно		Имя или ID сервера, к которому нужно присоединить том
state строка	Варианты: present ← absent	Ресурс должен присутствовать или отсутствовать.
timeout целое число	Значение по умолчанию: 180	Сколько времени Ansible должен ждать запрошенного ресурса.
validate_certs булево	Варианты: нет ← да	Нужно ли проверять запросы API SSL. До Ansible 2.3 это по умолчанию было `yes`. псевдонимы: verify
volume строка / обязательно		Имя или идентификатор тома, который нужно присоединить к серверу
wait булево	Варианты: нет да ←	Должен ли Ansible ждать, пока запрошенный ресурс не будет завершён.

Примечания

Примечание

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

Примеры

# Attaches a volume to a compute host
- name: attach a volume
  hosts: localhost
  tasks:
  - name: attach volume to host
    openstack.cloud.server_volume:
      state: present
      cloud: mordred
      server: Mysql-server
      volume: mysql-data
      device: /dev/vdb

Авторы

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_server_volume_module.html