os_image — Добавление/удаление изображений из облака OpenStack
Новое в версии 2.0.
Описание
- Добавление или удаление изображений из хранилища изображений OpenStack
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.7
- shade
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_timeout | Сколько времени должна ждать транспортная сокета, прежде чем истечет время ожидания для вызовов API. Если это опущено, ничего не будет передано в библиотеку requests. |
|
| auth | Словарь, содержащий информацию об авторизации, необходимую стратегии плагина авторизации облака. Для плагина password по умолчанию это будет содержать auth_url, username, password, project_name и любую информацию о доменах, если облако их поддерживает. Для других плагинов этот параметр должен содержать параметры, необходимые данному плагину. Этот параметр не нужен, если указано имя облака или присутствуют переменные среды OpenStack OS_*. |
|
| auth_type | Имя плагина авторизации для использования. Если облако использует что-то отличное от аутентификации по паролю, имя плагина должно быть указано здесь, а содержимое параметра auth должно быть соответствующим образом обновлено. |
|
| availability_zone | Игнорируется. Присутствует для обратной совместимости |
|
| cacert | Путь к пакету сертификатов CA, который может быть использован в рамках проверки запросов API SSL. |
|
| cert | Путь к клиенту сертификат для использования в рамках SSL транзакции. |
|
| checksum
(добавлено в 2.5) |
По умолчанию: None |
Контрольная сумма изображения |
| cloud | Наименованное облако или конфигурация облака для работы. Если cloud — строка, она ссылается на конфигурацию облака с именем, определённую в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если задан auth или присутствуют переменные среды OpenStack OS_*. Если cloud — словарь, он содержит полную конфигурацию облака, как в разделе clouds.yaml. |
|
| container_format | По умолчанию: bare |
Формат контейнера |
| disk_format | По умолчанию: qcow2 |
Формат диска, который загружается |
| filename | По умолчанию: None |
Путь к файлу, который должен быть загружен |
| id
(добавлено в 2.4) |
По умолчанию: None |
Идентификатор изображения |
| interface
(добавлено в 2.3) |
|
Тип URL конечной точки для получения из каталога сервисов. псевдонимы: endpoint_type |
| is_public | По умолчанию: yes |
Доступно ли изображение для общего доступа. Обратите внимание, что для публикации изображения по умолчанию требуется роль администратора. |
Примечания
Примечание
- Могут использоваться стандартные переменные среды OpenStack, такие как
OS_USERNAME, вместо явных значений. - Информация об авторизации управляется os-client-config, что означает, что значения могут поступать из файла yaml-конфигурации в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных среды, и, наконец, из явных параметров в ролях. Дополнительную информацию можно найти на http://docs.openstack.org/developer/os-client-config
Примеры
# Upload an image from a local file named cirros-0.3.0-x86_64-disk.img
- os_image:
auth:
auth_url: https://identity.example.com
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
Статус
Этот модуль помечен как preview, что означает, что он не гарантирует обратную совместимость интерфейса.
Автор
- Monty Taylor (@emonty)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/os_image_module.html
