os_flavor_facts – Получение фактов о вкусах одной или нескольких платформ
Новое в версии 2.1.
Краткое описание
- Получение фактов о доступных вкусах виртуальных машин 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. | |
| ephemeral boolean добавлено в 2.3 |
| Строка, используемая для фильтрации вкусов на основе объёма временного хранилища. Формат соответствует параметру ram |
| interface - добавлено в 2.3 |
| Тип URL конечной точки для извлечения из каталога сервисов. псевдонимы: endpoint_type |
| key - | Путь к клиентскому ключу для использования в SSL транзакции. | |
| limit - | Ограничивает количество возвращаемых вкусов. По умолчанию возвращаются все соответствующие вкусы. | |
| name - | Имя вкуса. Не может использоваться с ram, vcpus или ephemeral. | |
| ram boolean |
| Строка, используемая для фильтрации вкусов на основе объёма ОЗУ (в МБ). Эта строка принимает следующие специальные значения: 'MIN' (возвращает вкусы с минимальным объёмом ОЗУ), и 'MAX' (возвращает вкусы с максимальным объёмом ОЗУ). Также может быть указан конкретный объём ОЗУ. Будут возвращены все вкусы с этим точным объёмом ОЗУ. Может быть задан диапазон приемлемого объёма ОЗУ с использованием специального синтаксиса. Достаточно префикснуть объём ОЗУ одним из следующих значений диапазона: '<', '>', '<=', '>=': Эти значения представляют меньше чем, больше чем, меньше или равно, и больше или равно, соответственно. |
| region_name - | Имя региона. | |
| timeout - | Значение по умолчанию: 180 | Сколько времени Ansible должно ждать запрашиваемого ресурса. |
| vcpus boolean |
| Строка, используемая для фильтрации вкусов на основе количества виртуальных процессоров. Формат аналогичен параметру ram. |
| verify boolean |
| Проверять ли SSL запросы к API. До версии 2.3, это значение по умолчанию было True. псевдонимы: validate_certs |
| wait boolean |
| Должен ли Ansible ждать, пока запрашиваемый ресурс не будет завершён. |
Примечания
Примечание
- Этот модуль создаёт новый факт верхнего уровня
openstack_flavors, который содержит список несортированных вкусов. - Стандартные переменные окружения 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
Примеры
# Gather facts about all available flavors
- os_flavor_facts:
cloud: mycloud
# Gather facts for the flavor named "xlarge-flavor"
- os_flavor_facts:
cloud: mycloud
name: "xlarge-flavor"
# Get all flavors that have exactly 512 MB of RAM.
- os_flavor_facts:
cloud: mycloud
ram: "512"
# Get all flavors that have 1024 MB or more of RAM.
- os_flavor_facts:
cloud: mycloud
ram: ">=1024"
# Get a single flavor that has the minimum amount of RAM. Using the 'limit'
# option will guarantee only a single flavor is returned.
- os_flavor_facts:
cloud: mycloud
ram: "MIN"
limit: 1
# Get all flavors with 1024 MB of RAM or more, AND exactly 2 virtual CPUs.
- os_flavor_facts:
cloud: mycloud
ram: ">=1024"
vcpus: "2"
# Get all flavors with 1024 MB of RAM or more, exactly 2 virtual CPUs, and
# less than 30gb of ephemeral storage.
- os_flavor_facts:
cloud: mycloud
ram: ">=1024"
vcpus: "2"
ephemeral: "<30"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие являются полями, уникальными для данного модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| openstack_flavors сложный | При успехе. | Словарь, описывающий типы виртуальных машин. | |
| disk целое число | успех | Размер локального диска в ГБ. Пример: 10 | |
| ephemeral целое число | успех | Размер временного пространства в ГБ. Пример: 10 | |
| 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.7/modules/os_flavor_facts_module.html
