Spec-Zone.ru › Ansible 2.6

cs_template — Управляет шаблонами на облаках Apache CloudStack.

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

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

Описание

  • Регистрация шаблона из URL, создание шаблона из корневого тома остановленной ВМ или её снимка, извлечение и удаление шаблонов.

Требования

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

  • python >= 2.6
  • cs >= 0.6.10

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
account
Аккаунт, к которому относится шаблон, снимок или ВМ.
api_http_method
    Варианты:
  • get
  • post
HTTP-метод, используемый для запроса к API-точке.
Если не указан, используется переменная среды CLOUDSTACK_METHOD.
В качестве последнего варианта, значение берется из файла конфигурации ini, см. также примечания.
Значение по умолчанию — get, если не указано.
api_key
Ключ API CloudStack API.
Если не указан, используется переменная среды CLOUDSTACK_KEY.
В качестве последнего варианта, значение берется из файла конфигурации ini, см. также примечания.
api_region По умолчанию:
"cloudstack"
Имя раздела ini в файле cloustack.ini.
Если не указан, используется переменная среды CLOUDSTACK_REGION.
api_secret
Секретный ключ CloudStack API.
Если не задан, используется переменная среды CLOUDSTACK_SECRET.
В качестве последнего варианта, значение берется из файла конфигурации ini, см. также примечания.
api_timeout
Таймаут HTTP в секундах.
Если не указан, используется переменная среды CLOUDSTACK_TIMEOUT.
В качестве последнего варианта, значение берется из файла конфигурации ini, см. также примечания.
Значение по умолчанию — 10 секунд, если не указано.
api_url
URL CloudStack API, например, https://cloud.example.com/client/api.
Если не указан, используется переменная среды CLOUDSTACK_ENDPOINT.
В качестве последнего варианта, значение берется из файла конфигурации ini, см. также примечания.
bits По умолчанию:
64
Поддержка 32 или 64 бит.
checksum По умолчанию:
"no"
Значение MD5 контрольной суммы этого шаблона.
Если задано, мы ищем по контрольной сумме вместо имени.
cross_zones По умолчанию:
"no"
Синхронизировать или удалить шаблон между зонами.
Используется только если state присутствует или отсутствует.
details
Детали шаблона в виде пар ключ/значение.
display_text
Текст для отображения шаблона.
domain
Домен, к которому относится шаблон, снимок или ВМ.
format
    Варианты:
  • QCOW2
  • RAW
  • VHD
  • OVA
Формат шаблона.
Актуально при использовании state=present.
hypervisor
    Варианты:
  • KVM
  • VMware
  • BareMetal
  • XenServer
  • LXC
  • HyperV
  • UCS
  • OVM
  • Simulator
Имя гипервизора, используемого для создания нового шаблона.
Актуально при использовании state=present.
is_dynamically_scalable По умолчанию:
"no"
Зарегистрировать шаблон с установленным инструментом XS/VMWare для поддержки динамического масштабирования ЦП/памяти ВМ.
Используется только если state присутствует.
is_extractable По умолчанию:
"no"
Истина, если шаблон или его производные могут быть извлечены.
is_featured По умолчанию:
"no"
Зарегистрировать шаблон в качестве выделенного.
Используется только если state присутствует.
is_public По умолчанию:
"no"
Зарегистрировать шаблон для общего доступа всем пользователям.
Используется только если state присутствует.
is_ready По умолчанию:
"no"
Этот флаг используется для поиска существующих шаблонов.
Если установлено значение true, будут отображаться только шаблоны, готовые к развертыванию (например, успешно загруженные и установленные).
Рекомендуется установить значение false.
is_routing
Истина, если тип шаблона — маршрутизация (т.е., если шаблон используется для развертывания маршрутизатора).
Учитывается только если используется url.
mode
    Варианты:
  • http_download ←
  • ftp_upload
Режим извлечения шаблона.
Используется только если state=extracted.
name
обязательно
Имя шаблона.
os_type
Тип ОС, наиболее точно отражающий ОС этого шаблона.
password_enabled По умолчанию:
"no"
Истина, если шаблон поддерживает функцию сброса пароля.
poll_async По умолчанию:
"yes"
Ожидать завершения асинхронных задач.
project
Имя проекта, в котором должен быть зарегистрирован шаблон.
requires_hvm По умолчанию:
"no"
Истина, если для этого шаблона требуется HVM.
snapshot
Имя снимка, созданного из корневого тома ВМ, на основе которого будет создан шаблон.
Требуется vm, вместе с этим аргументом.
sshkey_enabled По умолчанию:
"no"
Истина, если шаблон поддерживает функцию загрузки ключа ssh.
state
    Варианты:
  • present ←
  • absent
  • extracted
Состояние шаблона.
tags
(добавлено в 2.4)
Список тегов. Теги — список словарей, имеющих ключи key и value.
Для удаления всех тегов, установите пустой список, например, tags: [].

псевдонимы: тег
template_filter
    Варианты:
  • featured
  • self ←
  • selfexecutable
  • sharedexecutable
  • executable
  • community
Имя фильтра, используемого для поиска шаблона.
template_tag
Тег для этого шаблона.
url
URL, где размещён шаблон на state=present.
URL, на который будет извлечен шаблон на state=extracted.
Взаимоисключающее с vm.
vm
Имя ВМ, на основе тома или снимка которой будет создан шаблон.
ВМ должна быть остановлена, если создаётся из тома.
Взаимоисключающее с url.
zone
Имя зоны, в которой необходимо зарегистрировать или удалить шаблон.
Если не указано, используется первая найденная зона.

Примечания

Примечание

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

Примеры

- name: register a systemvm template
  local_action:
    module: cs_template
    name: systemvm-vmware-4.5
    url: "http://packages.shapeblue.com/systemvmtemplate/4.5/systemvm64template-4.5-vmware.ova"
    hypervisor: VMware
    format: OVA
    cross_zones: yes
    os_type: Debian GNU/Linux 7(64-bit)

- name: create a template from a stopped virtual machine's volume
  local_action:
    module: cs_template
    name: debian-base-template
    vm: debian-base-vm
    os_type: Debian GNU/Linux 7(64-bit)
    zone: tokio-ix
    password_enabled: yes
    is_public: yes

- name: create a template from a virtual machine's root volume snapshot
  local_action:
    module: cs_template
    name: debian-base-template
    vm: debian-base-vm
    snapshot: ROOT-233_2015061509114
    os_type: Debian GNU/Linux 7(64-bit)
    zone: tokio-ix
    password_enabled: yes
    is_public: yes

- name: Remove a template
  local_action:
    module: cs_template
    name: systemvm-4.2
    cross_zones: yes
    state: absent

Значения возврата

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

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

Пример:
example account
checksum
строка
 успех
MD5 контрольная сумма шаблона.

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

Пример:
2015-03-29T14:57:06+0200
cross_zones
булево
 успех
true, если шаблон управляется во всех зонах, иначе false.
display_text
строка
 успех
Текст отображения шаблона.

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

Пример:
example domain
format
строка
 успех
Формат шаблона.

Пример:
OVA
hypervisor
строка
 успех
Гипервизор, связанный с этим шаблоном.

Пример:
VMware
id
строка
 успех
UUID шаблона.

Пример:
a6f7a5fc-43f8-11e5-a151-feff819cdc9f
is_extractable
булево
 успех
True, если шаблон извлекаем.

Пример:
True
is_featured
булево
 успех
True, если шаблон выделен.

Пример:
True
is_public
булево
 успех
True, если шаблон публичный.

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

Пример:
True
mode
строка
 успех
Режим извлечения

Пример:
http_download
name
строка
 успех
Имя шаблона.

Пример:
Debian 7 64-bit
os_type
строка
 успех
Тип операционной системы.

Пример:
CentOS 6.5 (64-bit)
password_enabled
булево
 успех
True, если функция сброса пароля включена, иначе false.
project
строка
 успех
Название проекта, к которому относится шаблон.

Пример:
Production
sshkey_enabled
булево
 успех
true, если для шаблона включен ssh-ключ, иначе false.
state
строка
 успех
Состояние извлеченного шаблона

Пример:
DOWNLOAD_URL_CREATED
status
строка
 успех
Статус шаблона.

Пример:
Загрузка завершена
tags
словарь
 успех
Список тегов ресурсов, связанных с шаблоном.

Пример:
[ { "key": "foo", "value": "bar" } ]
template_tag
строка
 успех
Тег шаблона, связанный с этим шаблоном.

Пример:
special
template_type
строка
 успех
Тип шаблона.

Пример:
USER
url
строка
 успех
Url, на который извлекается шаблон

Пример:
http://1.2.3.4/userdata/eb307f13-4aca-45e8-b157-a414a14e6b04.ova
zone
строка
 успех
Название зоны, в которой зарегистрирован шаблон.

Пример:
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_template_module.html

Spec-Zone.ru

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