Spec-Zone.ru › Ansible 2.6

cs_iso — Управление образами ISO на облаках Apache CloudStack.

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

  • Обзор
    • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус
  • Обслуживание
    • Автор

Обзор

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

Требования

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

  • python >= 2.6
  • cs >= 0.6.10

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
account
Аккаунт, к которому относится образ ISO.
api_http_method
    Варианты:
  • get
  • post
HTTP-метод, используемый для запроса к API-точке входа.
Если не указано, рассматривается переменная среды CLOUDSTACK_METHOD.
В качестве последнего варианта значение берется из файла конфигурации ini, см. также примечания.
Значение по умолчанию — get, если не указано.
api_key
API-ключ API CloudStack.
Если не указано, рассматривается переменная среды CLOUDSTACK_KEY.
В качестве последнего варианта значение берется из файла конфигурации ini, см. также примечания.
api_region По умолчанию:
"cloudstack"
Имя раздела ini в файле cloustack.ini.
Если не указано, рассматривается переменная среды CLOUDSTACK_REGION.
api_secret
Секретный ключ API CloudStack.
Если не задан, рассматривается переменная среды CLOUDSTACK_SECRET.
В качестве последнего варианта значение берется из файла конфигурации ini, см. также примечания.
api_timeout
Таймаут HTTP в секундах.
Если не указано, рассматривается переменная среды CLOUDSTACK_TIMEOUT.
В качестве последнего варианта значение берется из файла конфигурации ini, см. также примечания.
Значение по умолчанию — 10 секунд, если не указано.
api_url
URL API CloudStack, например, https://cloud.example.com/client/api.
Если не указано, рассматривается переменная среды CLOUDSTACK_ENDPOINT.
В качестве последнего варианта значение берется из файла конфигурации ini, см. также примечания.
bootable
Зарегистрировать образ ISO как загрузочный. Используется только если присутствует state.
checksum
Значение контрольной суммы MD5 этого образа ISO. Если установлено, поиск выполняется по контрольной сумме вместо имени.
cross_zones
bool

(добавлено в 2.4)
    Варианты:
  • нет ←
  • да
Указывает, нужно ли синхронизировать или удалять образ ISO между зонами.
Взаимоисключающее с zone.
display_text
(добавлено в 2.4)
Текст отображения образа ISO.
Если не указан, используется name.
domain
Домен, к которому относится образ ISO.
is_dynamically_scalable
Зарегистрировать образ ISO, на котором установлены инструменты XS/VMWare, для поддержки динамического масштабирования процессора/памяти ВМ. Используется только если присутствует state.
is_featured
Зарегистрировать образ ISO как рекомендуемый. Используется только если присутствует state.
is_public
Зарегистрировать образ ISO в общем доступе для всех пользователей. Используется только если присутствует state.
is_ready
bool
    Варианты:
  • нет ←
  • да
Этот флаг используется для поиска существующих образов ISO. Если установлен в yes, будут отображаться только готовые к развертыванию образы ISO (например, успешно загруженные и установленные). Рекомендуется установить в no.
iso_filter
    Варианты:
  • recommended
  • self ←
  • самовыполняемый
  • совместно выполняемый
  • выполняемый
  • сообщество
Имя фильтра, используемого для поиска образа ISO.
name
обязательно
Имя образа ISO.
os_type
Имя ОС, наиболее точно представляющее ОС этого образа ISO. Если образ загрузочный, этот параметр необходим. Требуется, если state присутствует.
poll_async
bool

(добавлено в 2.3)
    Варианты:
  • нет
  • да ←
Проверяет асинхронные задачи до завершения.
project
Имя проекта, в котором должен быть зарегистрирован образ ISO.
state
    Варианты:
  • present ←
  • absent
Состояние образа ISO.
tags
(добавлено в 2.4)
Список тегов. Теги — список словарей с ключами key и value.
Для удаления всех тегов установите пустой список, например, tags: [].

псевдонимы: тег
url
URL, откуда можно загрузить образ ISO. Требуется, если state присутствует.
zone
Имя зоны, в которой вы хотите зарегистрировать или удалить образ ISO.
Если не указано, используется первая найденная зона.

Примечания

Примечание

  • Ansible использует метод конфигурации библиотеки cs, если учетные данные не предоставлены аргументами api_url, api_key, api_secret. Конфигурация считывается из нескольких мест в следующем порядке. CLOUDSTACK_ENDPOINT, CLOUDSTACK_KEY, CLOUDSTACK_SECRET и CLOUDSTACK_METHOD. Переменные окружения CLOUDSTACK_TIMEOUT. Переменная окружения CLOUDSTACK_CONFIG, указывающая на файл .ini. Файл cloudstack.ini в текущем рабочем каталоге. Файл .cloudstack.ini в домашнем каталоге пользователя. Допускается указание нескольких учетных данных и точек входа с помощью разделов ini в cloudstack.ini. Используйте аргумент api_region для выбора имени раздела, раздел по умолчанию — cloudstack. Для получения дополнительной информации см. https://github.com/exoscale/cs.
  • Подробное руководство по модулям cloudstack можно найти в Руководстве по облаку CloudStack.
  • Этот модуль поддерживает режим проверки.

Примеры

# Register an ISO if ISO name does not already exist.
- local_action:
    module: cs_iso
    name: Debian 7 64-bit
    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)

# Register an ISO with given name if ISO md5 checksum does not already exist.
- local_action:
    module: cs_iso
    name: Debian 7 64-bit
    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

# Remove an ISO by name
- local_action:
    module: cs_iso
    name: Debian 7 64-bit
    state: absent

# Remove an ISO by checksum
- local_action:
    module: cs_iso
    name: Debian 7 64-bit
    checksum: 0b31bccccb048d20b551f70830bb7ad0
    state: absent

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

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

Ключ Возвращаемое значение Описание
account
строка
 успех
Аккаунт, к которому относится ISO.

Пример:
example account
bootable
логическое значение

(добавлено в 2.4)
 успех
Истинно, если ISO загрузочный.

Пример:
True
checksum
строка
 успех
MD5 контрольная сумма ISO.

Пример:
0b31bccccb048d20b551f70830bb7ad0
created
строка
 успех
Дата регистрации.

Пример:
2015-03-29T14:57:06+0200
cross_zones
логическое значение

(добавлено в 2.4)
 успех
Истинно, если ISO управляется во всех зонах, иначе ложно.
display_text
строка
 успех
Текст, который должен отображаться для ISO.

Пример:
Debian 7.7 64-bit minimal 2015-03-19
domain
строка
 успех
Домен, к которому относится ISO.

Пример:
example domain
format
строка

(добавлено в 2.4)
 успех
Формат ISO.

Пример:
ISO
id
строка
 успех
UUID ISO.

Пример:
a6f7a5fc-43f8-11e5-a151-feff819cdc9f
is_featured
логическое значение

(добавлено в 2.4)
 успех
Истинно, если ISO выделен.

Пример:
True
is_public
логическое значение

(добавлено в 2.4)
 успех
Истинно, если ISO общедоступен.

Пример:
True
is_ready
логическое значение
 успех
Истинно, если ISO готов к развертыванию.

Пример:
True
name
строка
 успех
Название ISO.

Пример:
Debian 7 64-bit
os_type
строка

(добавлено в 2.4)
 успех
Тип ОС.

Пример:
CentOS 6.5 (64-bit)
project
строка
 успех
Проект, к которому относится ISO.

Пример:
example project
status
строка
 успех
Статус ISO.

Пример:
Успешно установлен
tags
словарь

(добавлено в 2.4)
 успех
Список тегов ресурсов, связанных с ISO.

Пример:
[ { "key": "foo", "value": "bar" } ]
zone
строка
 успех
Название зоны, в которой зарегистрирован ISO.

Пример:
zuerich


Статус

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

Техническое обслуживание

Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Подробную информацию см. в разделе Обслуживание и поддержка модулей.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

  • René Moser (@resmo)

Подсказка

Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.

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

Spec-Zone.ru

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