os_nova_flavor – Управление облачными флейврами OpenStack
Новая в версии 2.0.
Описание
- Добавление или удаление флейвров в OpenStack.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- openstacksdk
- python >= 2.7
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_timeout - | Сколько времени (в секундах) следует ожидать сокетному слою перед истечением времени ожидания для API-запросов. Если этот параметр опущен, библиотеке requests ничего не будет передано. | |
| auth - | Словарь, содержащий информацию об авторизации, необходимую для стратегии подключаемого модуля авторизации облака. Для стандартного подключаемого модуля password это будет содержать auth_url, username, password, project_name и любую информацию о домене, если облако её поддерживает. Для других подключаемых модулей этот параметр должен содержать необходимые параметры. Этот параметр не требуется, если указано имя облака или присутствуют переменные окружения OpenStack OS_*. | |
| auth_type - | Имя подключаемого модуля авторизации, которое следует использовать. Если облако использует что-то кроме парольной аутентификации, имя подключаемого модуля должно быть указано здесь, и содержимое параметра auth должно быть соответствующим образом обновлено. | |
| availability_zone - | Игнорируется. Присутствует для обратной совместимости. | |
| cacert - | Путь к пакету сертификатов CA, который может быть использован при проверке SSL-запросов к API. | |
| cert - | Путь к клиентскому сертификату, который следует использовать в рамках SSL-транзакции. | |
| cloud - | Используемое облако или конфигурация облака. Если cloud является строкой, она ссылается на конфигурацию облака, определённую в файле OpenStack clouds.yaml. Обеспечивает значения по умолчанию для auth и auth_type. Этот параметр не требуется, если предоставлен auth или присутствуют переменные окружения OpenStack OS_*. Если cloud является словарем, он содержит полную конфигурацию облака, как в разделе clouds.yaml. | |
| disk - | Размер локального диска в ГБ. | |
| ephemeral - | По умолчанию: 0 | Размер временного пространства в ГБ. |
| extra_specs - добавлено в 2.3 | Словарь метаданных | |
| flavorid - | По умолчанию: "auto" | Идентификатор флейвра. Это необязательно, так как уникальный UUID будет присвоен, если значение не указано. |
| interface - добавлено в 2.3 |
| Тип URL конечной точки, который нужно извлечь из каталога услуг. псевдонимы: endpoint_type |
| is_public boolean |
| Сделать флейвр доступным для всех. |
| key - | Путь к клиентскому ключу, который следует использовать в рамках SSL-транзакции. | |
| name - / обязательно | Имя флейвра. | |
| ram - | Объем памяти в МБ. | |
| region_name - | Имя региона. | |
| rxtx_factor - | По умолчанию: 1.0 | Коэффициент RX/TX. |
| state - |
| Указывает желаемое состояние ресурса. Если state равен 'present', то ram, vcpus и disk являются обязательными. Для этих параметров нет значений по умолчанию. |
| swap - | По умолчанию: 0 | Размер пространства подкачки в МБ. |
| timeout - | По умолчанию: 180 | Сколько времени Ansible будет ожидать запрашиваемый ресурс. |
| vcpus - | Количество виртуальных процессоров. | |
| verify boolean |
| Подтверждать ли SSL-API-запросы. До версии 2.3 это по умолчанию было True. псевдонимы: validate_certs |
| wait boolean |
| Следует ли Ansible ожидать завершения запрашиваемого ресурса. |
Примечания
Примечание
- Можно использовать стандартные переменные окружения OpenStack, такие как
OS_USERNAME, вместо явных значений. - Информация об авторизации управляется os-client-config, что означает, что значения могут быть взяты из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных окружения, и, наконец, из явных параметров в сценариях. Более подробную информацию можно найти по адресу http://docs.openstack.org/developer/os-client-config
Примеры
- name: "Create 'tiny' flavor with 1024MB of RAM, 1 virtual CPU, and 10GB of local disk, and 10GB of ephemeral."
os_nova_flavor:
cloud: mycloud
state: present
name: tiny
ram: 1024
vcpus: 1
disk: 10
ephemeral: 10
- name: "Delete 'tiny' flavor"
os_nova_flavor:
cloud: mycloud
state: absent
name: tiny
- name: Create flavor with metadata
os_nova_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 словарь | успех | Метаданные типа. Пример: {'quota:disk_read_iops_sec': 5000, 'aggregate_instance_extra_specs:pinned': False} | |
| id строка | успех | Идентификатор типа. Пример: 515256b8-7027-4d73-aa54-4e30a4a4a339 | |
| is_public булево | успех | Доступность типа для публичного использования. Пример: True | |
| name строка | успех | Имя типа. Пример: tiny | |
| ram целое число | успех | Объем памяти в МБ. Пример: 1024 | |
| swap целое число | успех | Размер пространства подкачки в МБ. Пример: 100 | |
| vcpus целое число | успех | Количество виртуальных процессоров. Пример: 2 | |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- David Shrewsbury (@Shrews)
Подсказка
Если вы заметили какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/os_nova_flavor_module.html
