Spec-Zone.ru › Ansible

Модуль ngine_io.cloudstack.iso — управление ISO-образами в облаках на базе Apache CloudStack.

Примечание

Этот модуль входит в коллекцию ngine_io.cloudstack (версия 3.0.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install ngine_io.cloudstack. Для использования этого модуля необходимы дополнительные компоненты. Подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: ngine_io.cloudstack.iso.

Добавлено в ngine_io.cloudstack 0.1.0

  • Краткое описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Регистрация и удаление ISO-образов.

Псевдонимы: cs_iso

Требования

Следующие требования необходимы на хосте, на котором выполняется этот модуль.

  • python >= 2.6
  • cs >= 0.9.0

Параметры

Параметр

Комментарии

account

string

Учетная запись, с которой связан ISO-образ.

api_http_method

string

Метод HTTP, используемый для запроса к конечной точке API.

Если параметр не задан, используется переменная окружения CLOUDSTACK_METHOD.

Варианты:

  • "get" ← (по умолчанию)
  • "post"

api_key

string / обязательный

Ключ API CloudStack.

Если параметр не задан, используется переменная окружения CLOUDSTACK_KEY.

api_secret

string / обязательный

Секретный ключ API CloudStack.

Если параметр не задан, используется переменная окружения CLOUDSTACK_SECRET.

api_timeout

integer

Тайм-аут HTTP в секундах.

Если параметр не задан, используется переменная окружения CLOUDSTACK_TIMEOUT.

По умолчанию: 10

api_url

string / обязательный

URL API CloudStack, например https://cloud.example.com/client/api.

Если параметр не задан, используется переменная окружения CLOUDSTACK_ENDPOINT.

api_verify_ssl_cert

string

Проверять файл сертификата центра сертификации.

Если параметр не задан, используется переменная окружения CLOUDSTACK_VERIFY.

bootable

boolean

Зарегистрировать ISO-образ как загрузочный. Используется только, если state имеет значение present.

Варианты:

  • false
  • true

checksum

string

Контрольная сумма MD5 этого ISO-образа. Если задана, поиск выполняется по контрольной сумме, а не по имени.

cross_zones

boolean

Следует ли синхронизировать ISO-образ между зонами или удалять его из всех зон.

Не может использоваться одновременно с zone.

Варианты:

  • false ← (по умолчанию)
  • true

display_text

string

Отображаемый текст ISO-образа.

Если не указан, будет использоваться name.

domain

string

Домен, с которым связан ISO-образ.

is_dynamically_scalable

boolean

Зарегистрировать ISO-образ с установленными инструментами XS/VMware для поддержки динамического масштабирования ЦП/памяти виртуальной машины. Используется только, если state имеет значение present.

Варианты:

  • false
  • true

is_featured

boolean

Зарегистрировать ISO-образ как рекомендуемый. Используется только, если state имеет значение present.

Варианты:

  • false
  • true

is_public

boolean

Зарегистрировать ISO-образ как общедоступный для всех пользователей. Используется только, если state имеет значение present.

Варианты:

  • false
  • true

is_ready

boolean

Этот флаг используется при поиске существующих ISO-образов. Если задано значение yes, будут отображаться только ISO-образы, готовые к развертыванию, например успешно загруженные и установленные. Рекомендуется установить значение no.

Варианты:

  • false ← (по умолчанию)
  • true

iso_filter

string

Имя фильтра для поиска ISO-образа.

Варианты:

  • "featured"
  • "self" ← (по умолчанию)
  • "selfexecutable"
  • "sharedexecutable"
  • "executable"
  • "community"

name

string / обязательный

Имя ISO-образа.

os_type

string

Имя ОС, наиболее точно соответствующей ОС этого ISO-образа. Если ISO-образ является загрузочным, этот параметр необходимо указать. Обязателен, если state имеет значение present.

poll_async

boolean

Ожидать завершения асинхронных заданий, опрашивая их состояние.

Варианты:

  • false
  • true ← (по умолчанию)

project

string

Имя проекта, в котором будет зарегистрирован ISO-образ.

state

string

Состояние ISO-образа.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

tags

псевдонимы: tag

list / элементы=dictionary

Список тегов. Теги представляют собой список словарей с ключами key и value.

Чтобы удалить все теги, задайте пустой список, например tags: [].

url

string

URL, по которому можно скачать ISO-образ. Обязателен, если state имеет значение present.

validate_certs

boolean

добавлено в ngine_io.cloudstack 2.4.0

Если задано значение false, SSL-сертификаты проверяться не будут.

Если параметр не задан, используется переменная окружения CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY.

Используйте этот параметр только на сайтах под вашим управлением, использующих самоподписанные сертификаты.

Варианты:

  • false
  • true ← (по умолчанию)

zone

string

Имя зоны, в которой необходимо зарегистрировать или удалить ISO-образ.

Обязателен, если cross_zones имеет значение no

Примечания

Примечание

  • Подробное руководство по модулям CloudStack см. в руководстве по облаку CloudStack.
  • Этот модуль поддерживает режим проверки.

Примеры

- name: Register an ISO if ISO name does not already exist
  ngine_io.cloudstack.iso:
    name: Debian 7 64-bit
    zone: zone01
    url: http://mirror.switch.ch/ftp/mirror/debian-cd/current/amd64/iso-cd/debian-7.7.0-amd64-netinst.iso
    os_type: Debian GNU/Linux 7(64-bit)

- name: Register an ISO with given name if ISO md5 checksum does not already exist
  ngine_io.cloudstack.iso:
    name: Debian 7 64-bit
    zone: zone01
    url: http://mirror.switch.ch/ftp/mirror/debian-cd/current/amd64/iso-cd/debian-7.7.0-amd64-netinst.iso
    os_type: Debian GNU/Linux 7(64-bit)
    checksum: 0b31bccccb048d20b551f70830bb7ad0

- name: Remove an ISO by name
  ngine_io.cloudstack.iso:
    name: Debian 7 64-bit
    zone: zone01
    state: absent

- name: Remove an ISO by checksum
  ngine_io.cloudstack.iso:
    name: Debian 7 64-bit
    zone: zone01
    checksum: 0b31bccccb048d20b551f70830bb7ad0
    state: absent

Возвращаемые значения

Общие возвращаемые значения описаны здесь. Ниже перечислены поля, уникальные для этого модуля:

Ключ

Описание

account

string

Учетная запись, с которой связан ISO-образ.

Возвращается: при успехе

Пример: "example account"

bootable

boolean

True, если ISO-образ является загрузочным.

Возвращается: при успехе

Пример: true

checksum

string

Контрольная сумма MD5 ISO-образа.

Возвращается: при успехе

Пример: "0b31bccccb048d20b551f70830bb7ad0"

created

string

Дата регистрации.

Возвращается: при успехе

Пример: "2015-03-29T14:57:06+0200"

cross_zones

boolean

true, если ISO-образ управляется во всех зонах; в противном случае false.

Возвращается: при успехе

Пример: false

display_text

string

Отображаемый текст ISO-образа.

Возвращается: при успехе

Пример: "Debian 7.7 64-bit minimal 2015-03-19"

domain

string

Домен, с которым связан ISO-образ.

Возвращается: при успехе

Пример: "example domain"

format

string

Формат ISO-образа.

Возвращается: при успехе

Пример: "ISO"

id

string

UUID ISO-образа.

Возвращается: при успехе

Пример: "a6f7a5fc-43f8-11e5-a151-feff819cdc9f"

is_featured

boolean

True, если ISO-образ отмечен как рекомендуемый.

Возвращается: при успехе

Пример: true

is_public

boolean

True, если ISO-образ является общедоступным.

Возвращается: при успехе

Пример: true

is_ready

boolean

True, если ISO-образ готов к развертыванию.

Возвращается: при успехе

Пример: true

name

string

Имя ISO-образа.

Возвращается: при успехе

Пример: "Debian 7 64-bit"

os_type

string

Тип ОС.

Возвращается: при успехе

Пример: "CentOS 6.5 (64-bit)"

project

string

Проект, с которым связан ISO-образ.

Возвращается: при успехе

Пример: "example project"

status

string

Состояние ISO-образа.

Возвращается: при успехе

Пример: "Successfully Installed"

tags

dictionary

Список тегов ресурса, связанных с ISO-образом.

Возвращается: при успехе

Пример: "[ { \"key\": \"foo\", \"value\": \"bar\" } ]"

zone

string

Имя зоны, в которой зарегистрирован ISO-образ.

Возвращается: при успехе

Пример: "zuerich"

Авторы

  • René Moser (@resmo)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/ngine_io/cloudstack/iso_module.html

Spec-Zone.ru

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