os_nova_flavor – Управление вкусами вычислений OpenStack
Новая версия с 2.0.
Обзор
- Добавление или удаление вкусов из OpenStack.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- openstacksdk
- python >= 2.7
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_timeout целое число | Сколько времени должна ожидать сокетная прослойка перед истечением времени ожидания для API-вызовов. Если это опущено, ничего не будет передано в библиотеку requests. | |
| auth словарь | Словарь, содержащий информацию об авторизации, необходимую стратегии подключаемого модуля авторизации облака. Для стандартного подключаемого модуля password, он будет содержать auth_url, username, password, project_name и любую информацию о доменных областях (например, os_user_domain_name или os_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 - | Размер локального диска в ГБ. | |
| ephemeral - | Значение по умолчанию: 0 | Размер временного пространства в ГБ. |
| extra_specs - добавлен в 2.3 | Словарь метаданных | |
| flavorid - | Значение по умолчанию: "auto" | Идентификатор вкуса. Это необязательно, так как будет назначен уникальный UUID, если значение не указано. |
| interface строка добавлен в 2.3 |
| Тип 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, затем из стандартных переменных окружения, и, наконец, из явных параметров в playbook. Дополнительную информацию можно найти по адресу 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."
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. [сообщество]
Авторы
- 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.8/modules/os_nova_flavor_module.html