Spec-Zone.ru › Ansible 2.10

openstack.cloud.os_image – Добавление/удаление образов из OpenStack Cloud

Примечание

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

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

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

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

Обзор

  • Добавление или удаление образов из хранилища образов 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
checksum
строка
Контрольная сумма образа
client_cert
строка
Путь к клиенту сертификат для использования в рамках SSL-транзакции.

псевдонимы: cert
client_key
строка
Путь к ключу клиента для использования в рамках SSL-транзакции.

псевдонимы: key
cloud
сырые данные
Именованное облако или конфигурация облака для работы с ним. Если cloud является строкой, она ссылается на именованную конфигурацию облака, определённую в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если предоставлен параметр auth или присутствуют переменные окружения OpenStack OS_*. Если cloud является словарем, он содержит полную конфигурацию облака, как в разделе clouds.yaml.
container_format
строка
    Варианты:
  • ami
  • aki
  • ari
  • bare ←
  • ovf
  • ova
  • docker
Формат контейнера
disk_format
строка
    Варианты:
  • ami
  • ari
  • aki
  • vhd
  • vmdk
  • raw
  • qcow2 ←
  • vdi
  • iso
  • vhdx
  • ploop
Формат диска, который загружается
filename
строка
Путь к файлу, который должен быть загружен
id
строка
Идентификатор образа при загрузке образа
interface
строка
    Варианты:
  • admin
  • internal
  • public ←
Тип URL конечной точки для извлечения из каталога служб.

псевдонимы: endpoint_type
is_public
булево
    Варианты:
  • нет ←
  • да
Доступность образа для общедоступного использования. Обратите внимание, что опубликование образа требует роли администратора по умолчанию.
kernel
строка
Имя существующего образа ядра, которое будет ассоциировано с этим образом
min_disk
целое число
Минимальный объём диска (в ГБ), необходимый для загрузки этого образа
min_ram
целое число
Минимальный объём оперативной памяти (в МБ), необходимый для загрузки этого образа
name
строка / обязательно
Имя образа при загрузке — или имя/ИД образа при удалении
owner
строка
Владелец образа
properties
словарь
Значение по умолчанию:
{}
Дополнительные свойства, которые будут ассоциированы с этим образом
protected
булево
    Варианты:
  • нет ←
  • да
Запретить удаление образа
ramdisk
строка
Имя существующего образа ramdisk, который будет ассоциирован с этим образом
region_name
строка
Название региона.
state
строка
    Варианты:
  • present ←
  • absent
Ресурс должен быть присутствующим или отсутствующим.
timeout
целое число
Значение по умолчанию:
180
Сколько времени Ansible должен ждать запрашиваемого ресурса.
validate_certs
булево
    Варианты:
  • нет ←
  • да
Необходимо ли проверять SSL-API-запросы.
До Ansible 2.3 это было по умолчанию yes.

псевдонимы: verify
volume
строка
ИД тома для создания образа.
Том должен быть в состоянии AVAILABLE.
wait
булево
    Варианты:
  • нет
  • да ←
Должен ли Ansible ждать завершения запрошенного ресурса.

Примечания

Примечание

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

Примеры

# Upload an image from a local file named cirros-0.3.0-x86_64-disk.img
- openstack.cloud.image:
    auth:
      auth_url: https://identity.example.com
      username: admin
      password: passme
      project_name: admin
      openstack.cloud.identity_user_domain_name: Default
      openstack.cloud.project_domain_name: Default
    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

# Create image from volume attached to an instance
- name: create volume snapshot
  openstack.cloud.volume_snapshot:
    auth:
      "{{ auth }}"
    display_name: myvol_snapshot
    volume: myvol
    force: yes
  register: myvol_snapshot

- name: create volume from snapshot
  openstack.cloud.volume:
    auth:
      "{{ auth }}"
    size: "{{ myvol_snapshot.snapshot.size }}"
    snapshot_id: "{{ myvol_snapshot.snapshot.id }}"
    display_name: myvol_snapshot_volume
    wait: yes
  register: myvol_snapshot_volume

- name: create image from volume snapshot
  openstack.cloud.image:
    auth:
      "{{ auth }}"
    volume: "{{ myvol_snapshot_volume.volume.id }}"
    name: myvol_image

Авторы

  • 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_image_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API