os_image - Добавление/удаление изображений из облака OpenStack

Новое в версии 2.0.

Описание
Требования (к хосту, на котором выполняется модуль)
Параметры
Примеры
Примечания
- Статус

Описание

Добавление или удаление изображений из хранилища изображений OpenStack

Требования (к хосту, на котором выполняется модуль)

python >= 2.7
shade

Параметры

параметр	обязательный	значение по умолчанию	выбор	комментарии
api_timeout	нет	None		Сколько времени должна ждать сокет-слой, прежде чем истечет время ожидания для вызовов API. Если этот параметр опущен, ничего не будет передано библиотеке requests.
auth	нет			Словарь, содержащий информацию об авторизации, необходимую для стратегии подключаемого модуля аутентификации облака. Для стандартного плагина password он будет содержать auth_url, username, password, project_name и любую информацию о доменах, если облако их поддерживает. Для других плагинов этот параметр должен содержать требуемые параметры плагина аутентификации. Этот параметр не нужен, если указано имя облака или присутствуют переменные окружения OpenStack OS_*.
auth_type	нет	password		Имя плагина аутентификации для использования. Если облако использует аутентификацию, отличную от парольной, здесь следует указать имя плагина, и содержимое параметра auth следует соответствующим образом обновить.
availability_zone	нет			Игнорируется. Присутствует для обратной совместимости
cacert	нет	None		Путь к пакету сертификатов CA, который можно использовать для проверки запросов API SSL.
cert	нет	None		Путь к клиенту сертификат для использования в рамках транзакции SSL.
cloud	нет			Наименование облака для работы. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если задан auth или присутствуют переменные окружения OpenStack OS_*.
container_format	нет	bare		Формат контейнера
disk_format	нет	qcow2		Формат диска, который загружается
endpoint_type	нет	public	public internal admin	Тип URL-адреса конечной точки для извлечения из каталога служб.
filename	нет	None		Путь к файлу, который нужно загрузить
id (добавлено в 2.4)	нет	None		Идентификатор изображения
is_public	нет	yes		Доступно ли изображение для общего доступа. Обратите внимание, что для публикации изображения по умолчанию требуется роль администратора.
kernel	нет	None		Имя существующего ядра изображения, которое будет связано с этим изображением
key	нет	None		Путь к ключу клиента для использования в рамках транзакции SSL.
min_disk	нет	None		Минимальный объем диска (в ГБ), необходимый для загрузки этого изображения
min_ram	нет	None		Минимальный объем ОЗУ (в МБ), необходимый для загрузки этого изображения
name	да	None		Имя, которое нужно задать изображению
owner	нет	None		Владелец изображения
properties	нет			Дополнительные свойства, которые нужно связать с этим изображением
ramdisk	нет	None		Имя существующего изображения ramdisk, которое будет связано с этим изображением
region_name	нет			Имя региона.
state	нет	present	present absent	Ресурс должен быть present или absent.
timeout	нет	180		Сколько времени Ansible должно ждать запрошенного ресурса.
validate_certs	нет			Требуется ли проверка запросов API SSL. До версии 2.3 по умолчанию было True. псевдонимы: verify
wait	нет	yes	yes no	Ansible должен ждать завершения запрошенного ресурса.

Примеры

# Upload an image from a local file named cirros-0.3.0-x86_64-disk.img
- os_image:
    auth:
      auth_url: http://localhost/auth/v2.0
      username: admin
      password: passme
      project_name: admin
    name: cirros
    container_format: bare
    disk_format: qcow2
    state: present
    filename: cirros-0.3.0-x86_64-disk.img
    kernel: cirros-vmlinuz
    ramdisk: cirros-initrd
    properties:
      cpu_arch: x86_64
      distro: ubuntu

Примечания

Примечание

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

Статус

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

Чтобы получить помощь в разработке модулей, если вы так решите, ознакомьтесь со статьей Информация о сообществе и участие, Тестирование Ansible и Разработка модулей.

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