ngine_io.cloudstack.cs_image_store – Управляет хранилищами изображений CloudStack.

Примечание

Этот плагин является частью коллекции ngine_io.cloudstack (версия 1.1.0).

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

Чтобы использовать его в книге задач, укажите: ngine_io.cloudstack.cs_image_store.

Новое в версии 0.1.0: плагина ngine_io.cloudstack

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

Обзор

Развертывание, удаление, повторное создание хранилищ изображений CloudStack.

Требования

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

python >= 2.6
cs >= 0.9.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
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, см. также примечания.
api_verify_ssl_cert строка		Файл сертификата CA. Если не задано, используется переменная среды `CLOUDSTACK_VERIFY`. В качестве последнего варианта, значение берется из файла конфигурации ini, см. также примечания. Значение по умолчанию: `null`, если не указано.
force_recreate логическое	Варианты: нет ← да	Установите значение `yes`, если вы изменяете существующее хранилище изображений. Это принудительно пересоздаст хранилище изображений. Пересоздание может завершиться ошибкой, если в хранилище изображений имеются снимки. Удалите их перед запуском пересоздания.
name строка / обязательно		Идентификатор хранилища изображений. Требуется при удалении хранилища изображений.
provider строка		Имя поставщика хранилища изображений. Требуется при создании нового хранилища изображений
state строка	Варианты: present ← absent	Стадия хранилища изображений
url строка		URL хранилища изображений. Требуется, когда state=present.
zone строка / обязательно		Имя зоны для хранилища изображений.

Примечания

Примечание

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.
Этот модуль поддерживает режим проверки.

Примеры

- name: Add a Image Store (NFS)
  ngine_io.cloudstack.cs_image_store:
    zone: zone-01
    name: nfs-01
    provider: NFS
    url: nfs://192.168.21.16/exports/secondary


# Change the NFS share URL and force a Image Store recreation
- name: Change the NFS url
  ngine_io.cloudstack.cs_image_store:
    zone: zone-01
    name: nfs-01
    provider: NFS
    force_recreate: yes
    url: nfs://192.168.21.10/shares/secondary

- name: delete the image store
  ngine_io.cloudstack.cs_image_store:
    name: nfs-01
    zone: zone-01
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
id строка	успех	идентификатор хранилища изображений Пример: feb11a84-a093-45eb-b84d-7f680313c40b
name строка	успех	имя хранилища изображений Пример: nfs-01
protocol строка	успех	протокол хранилища изображений Пример: nfs
provider_name строка	успех	имя поставщика хранилища изображений Пример: NFS
scope строка	успех	область действия хранилища изображений Пример: ZONE
url строка	успех	URL хранилища изображений Пример: nfs://192.168.21.16/exports/secondary
zone строка	успех	имя зоны хранилища изображений Пример: zone-01

Авторы

Patryk Cichy (@PatTheSilent)

© 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/ngine_io/cloudstack/cs_image_store_module.html