openstack.cloud.compute_flavor – Управление виртуальными машинами OpenStack

Примечание

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

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

Для использования в playbook укажите: openstack.cloud.compute_flavor.

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

Обзор

Добавление или удаление виртуальных машин из 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), если облако их поддерживает. Для других плагинов этот параметр должен содержать параметры, необходимые этому плагину. Этот параметр не требуется, если задан параметр cloud или присутствуют переменные окружения OpenStack OS_*.
auth_type строка		Имя плагина аутентификации для использования. Если облако использует что-то кроме аутентификации по паролю, имя плагина должно быть указано здесь, а содержимое параметра auth должно быть соответствующим образом обновлено.
availability_zone строка		Игнорируется. Присутствует для обратной совместимости
ca_cert строка		Путь к пакету сертификатов CA, который может использоваться для проверки запросов SSL API. псевдонимы: cacert
client_cert строка		Путь к клиенту сертификата для использования в рамках транзакции SSL. псевдонимы: cert
client_key строка		Путь к ключу клиента для использования в рамках транзакции SSL. псевдонимы: key
cloud необработанный		Именованное облако или конфигурация облака для работы. Если cloud является строкой, она ссылается на именованную конфигурацию облака, определенную в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан параметр auth или присутствуют переменные окружения OpenStack OS_. Если cloud* является словарем, он содержит полную конфигурацию облака, как в секции clouds.yaml.
disk целое число	По умолчанию: 0	Размер локального диска в ГБ.
ephemeral целое число	По умолчанию: 0	Размер временного пространства в ГБ.
extra_specs словарь		Словарь метаданных
flavorid строка	По умолчанию: "auto"	Идентификатор виртуальной машины. Это необязательно, так как уникальный UUID будет назначен, если значение не указано.
interface строка	Варианты: admin internal public ←	Тип URL конечной точки для извлечения из каталога сервисов. псевдонимы: endpoint_type
is_public булево	Варианты: no yes ←	Сделать виртуальную машину доступной для публичного доступа.
name строка / обязательно		Название виртуальной машины.
ram целое число		Объем памяти в МБ.
region_name строка		Название региона.
rxtx_factor вещественное число	По умолчанию: 1.0	Коэффициент RX/TX.
state строка	Варианты: present ← absent	Указывает желаемое состояние ресурса. Когда state равен 'present', тогда ram, vcpus и disk являются обязательными. Для этих параметров нет значений по умолчанию.
swap целое число	По умолчанию: 0	Размер пространства подкачки в МБ.
timeout целое число	По умолчанию: 180	Сколько времени Ansible должен ждать запрошенного ресурса.
validate_certs булево	Варианты: no ← yes	Должны ли проверяться запросы SSL API? До Ansible 2.3 это имело значение `yes`. псевдонимы: verify
vcpus целое число		Количество виртуальных ЦП.
wait булево	Варианты: no yes ←	Должен ли Ansible ждать завершения запрошенного ресурса?

Примечания

Примечание

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

Примеры

- name: "Create 'tiny' flavor with 1024MB of RAM, 1 virtual CPU, and 10GB of local disk, and 10GB of ephemeral."
  openstack.cloud.compute_flavor:
    cloud: mycloud
    state: present
    name: tiny
    ram: 1024
    vcpus: 1
    disk: 10
    ephemeral: 10

- name: "Delete 'tiny' flavor"
  openstack.cloud.compute_flavor:
    cloud: mycloud
    state: absent
    name: tiny

- name: Create flavor with metadata
  openstack.cloud.compute_flavor:
    cloud: mycloud
    state: present
    name: tiny
    ram: 1024
    vcpus: 1
    disk: 10
    extra_specs:
      "quota:disk_read_iops_sec": 5000
      "aggregate_instance_extra_specs:pinned": false

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

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

Ключ		Возвращаемое значение	Описание
flavor сложный тип		При успехе, когда state равен 'present'	Словарь, описывающий виртуальную машину.
	disk целое число	успех	Размер локального диска в ГБ. Пример: 10
	ephemeral целое число	успех	Размер временного пространства в ГБ. Пример: 10
	extra_specs словарь	успех	Метаданные виртуальной машины Пример: {'aggregate_instance_extra_specs:pinned': False, 'quota:disk_read_iops_sec': 5000}
	id строка	успех	Идентификатор виртуальной машины. Пример: 515256b8-7027-4d73-aa54-4e30a4a4a339
	is_public булево	успех	Сделать виртуальную машину доступной для публичного доступа. Пример: True
	name строка	успех	Название виртуальной машины. Пример: tiny
	ram целое число	успех	Объем памяти в МБ. Пример: 1024
	swap целое число	успех	Размер пространства подкачки в МБ. Пример: 100
	vcpus целое число	успех	Количество виртуальных ЦП. Пример: 2

Авторы

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/compute_flavor_module.html