openstack.cloud.os_nova_flavor – Управление вкусами вычислений OpenStack
Примечание
Этот плагин входит в состав коллекции openstack.cloud (версия 1.2.1).
Для его установки используйте: ansible-galaxy collection install openstack.cloud.
Для использования в книге задач укажите: openstack.cloud.os_nova_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), если облако их поддерживает. Для других плагинов этот параметр должен содержать все параметры, необходимые для плагина авторизации. Этот параметр не нужен, если указано имя облака или присутствуют переменные среды 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 строка |
| Тип URL конечной точки для получения из каталога сервисов. псевдонимы: endpoint_type |
| is_public булево |
| Сделать вкус доступным для общественности. |
| name строка / обязательно | Имя вкуса. | |
| ram целое число | Количество памяти в МБ. | |
| region_name строка | Название региона. | |
| rxtx_factor число с плавающей точкой | Значение по умолчанию: 1.0 | Коэффициент RX/TX. |
| state строка |
| Указать желаемое состояние ресурса. Когда state равен 'present', тогда ram, vcpus и disk являются необходимыми. Для этих параметров нет значений по умолчанию. |
| swap целое число | Значение по умолчанию: 0 | Размер пространства подкачки в МБ. |
| timeout целое число | Значение по умолчанию: 180 | Сколько времени Ansible должен ждать запрошенного ресурса. |
| validate_certs булево |
| Нужно ли проверять SSL API-запросы. До Ansible 2.3 это имело значение по умолчанию yes.псевдонимы: verify |
| vcpus целое число | Количество виртуальных процессоров. | |
| wait булево |
| Должен ли Ansible ждать завершения запрошенного ресурса. |
Примечания
Примечание
- Можно использовать стандартные переменные среды OpenStack, такие как
OS_USERNAME, вместо явного указания значений. - Информация об авторизации управляется openstacksdk, что означает, что значения могут поступать из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных среды, а затем — явных параметров в задачах. Дополнительную информацию можно найти по адресу 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/os_nova_flavor_module.html