os_image – Добавление/удаление изображений из облака OpenStack
Новое в версии 2.0.
Обзор
- Добавление или удаление изображений из репозитория изображений OpenStack
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- openstacksdk
- python >= 2.7
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_timeout - | Сколько времени должна ждать сокет-слой перед истечением времени ожидания для вызовов API. Если этот параметр опущен, в библиотеку запросов ничего не будет передано. | |
| auth - | Словарь, содержащий информацию об авторизации, необходимую стратегии плагина авторизации облака. Для стандартного плагина password он должен содержать auth_url, username, password, project_name и любую информацию о доменах, если облако их поддерживает. Для других плагинов этот параметр должен содержать необходимые параметры данного плагина авторизации. Этот параметр не нужен, если указано имя облака или присутствуют переменные окружения OpenStack OS_*. | |
| auth_type - | Имя плагина авторизации, который следует использовать. Если облако использует что-то кроме парольной аутентификации, здесь следует указать имя плагина, и содержимое параметра auth должно быть соответствующим образом обновлено. | |
| availability_zone - | Игнорируется. Присутствует для обратной совместимости | |
| cacert - | Путь к пакету сертификата CA, который может использоваться для проверки запросов API SSL. | |
| cert - | Путь к клиенту сертификат, который следует использовать в процессе SSL-транзакции. | |
| checksum - добавлено в 2.5 | Контрольная сумма изображения | |
| cloud - | Именованное облако или конфигурация облака для работы. Если cloud — строка, она ссылается на конфигурацию именованного облака, определённую в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан auth или присутствуют переменные окружения OpenStack OS_*. Если cloud — словарь, он содержит полную конфигурацию облака, аналогично тому, как это определено в разделе clouds.yaml. | |
| container_format - | По умолчанию: "bare" | Формат контейнера |
| disk_format - | По умолчанию: "qcow2" | Формат диска, который загружается |
| filename - | Путь к файлу, который нужно загрузить | |
| id - добавлено в 2.4 | Идентификатор изображения | |
| interface - добавлено в 2.3 |
| Тип URL конечной точки для извлечения из каталога служб. псевдонимы: endpoint_type |
| is_public boolean |
| Доступно ли изображение для общего доступа. Обратите внимание, что для публикации изображения по умолчанию требуется роль администратора. |
| kernel - | Имя существующего ядра, которое будет связано с этим изображением | |
| key - | Путь к ключу клиента, который следует использовать в процессе SSL-транзакции. | |
| min_disk - | Минимальный объем диска (в ГБ), необходимый для загрузки этого изображения | |
| min_ram - | Минимальный объем оперативной памяти (в МБ), необходимый для загрузки этого изображения | |
| name - / обязательно | Имя, которое должно быть присвоено изображению | |
| owner - | Владелец изображения | |
| properties - | По умолчанию: {} | Дополнительные свойства, которые следует связать с этим изображением |
| ramdisk - | Имя существующего изображения ramdisk, которое будет связано с этим изображением | |
| region_name - | Имя региона. | |
| state - |
| Ресурс должен быть присутствовать или отсутствовать. |
| timeout - | По умолчанию: 180 | Сколько времени Ansible должно ждать запрошенного ресурса. |
| verify boolean |
| Нужно ли проверять запросы API SSL. До версии 2.3 по умолчанию было True. псевдонимы: validate_certs |
| wait boolean |
| Должен ли Ansible ждать завершения запрошенного ресурса. |
Примечания
Примечание
- Можно использовать стандартные переменные окружения 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
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.7/modules/os_image_module.html
