os_flavor_facts - Получение фактов о одном или нескольких вкусах
Новая версия 2.1.
Обзор
- Получение фактов о доступных вкусах экземпляров OpenStack. По умолчанию, извлекаются факты обо всех вкусах. Можно применить фильтры, чтобы получить факты только для соответствующих вкусов. Например, можно фильтровать по объёму доступной оперативной памяти или числу виртуальных ЦП, или по обоим параметрам. При указании нескольких фильтров все фильтры должны соответствовать вкусу, прежде чем этот вкус будет возвращён в качестве факта.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
- python >= 2.7
- shade
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| 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 (добавлено в 2.3) | По умолчанию: нет | Строка, используемая для фильтрации вкусов на основе количества временного хранилища. Формат такой же, как у параметра ram |
| interface (добавлено в 2.3) |
| Тип URL-адреса конечной точки для извлечения из каталога служб. псевдонимы: endpoint_type |
| key | Путь к клиенту ключ для использования в рамках SSL-транзакции. | |
| limit | По умолчанию: None | Ограничивает количество возвращаемых вкусов. По умолчанию возвращаются все соответствующие вкусы. |
| name | По умолчанию: None | Имя вкуса. Не может использоваться с ram или vcpus или ephemeral. |
| ram | По умолчанию: нет | Строка, используемая для фильтрации вкусов на основе требуемого объема оперативной памяти (в МБ). Эта строка принимает следующие специальные значения: 'MIN' (возвращает вкусы с минимальным объёмом оперативной памяти), и 'MAX' (возвращает вкусы с максимальным объёмом оперативной памяти). Также может быть указан конкретный объем оперативной памяти. Будут возвращены все вкусы с этим точным объёмом оперативной памяти. Можно указать диапазон допустимых значений оперативной памяти, используя специальный синтаксис. Просто добавьте одно из следующих допустимых значений диапазона к количеству оперативной памяти: '<', '>', '<=', '>=': меньше, больше, меньше или равно, и больше или равно соответственно. |
| region_name | Название региона. | |
| timeout | По умолчанию: 180 | Сколько времени Ansible будет ждать запрашиваемый ресурс. |
| vcpus | По умолчанию: нет | Строка, используемая для фильтрации вкусов на основе требуемого числа виртуальных ЦП. Формат такой же, как у параметра ram. |
| verify |
| Нужно ли проверять SSL API-запросы. До версии 2.3 по умолчанию было True. псевдонимы: validate_certs |
| wait |
| Должен ли 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 сложный | При успехе. | Словарь, описывающий вкусы. | |
| name строка | успех | Имя вкуса. Пример: tiny | |
| ram целое число | успех | Объём памяти в МБ. Пример: 1024 | |
| ephemeral целое число | успех | Размер временного хранилища в ГБ. Пример: 10 | |
| vcpus целое число | успех | Количество виртуальных ЦП. Пример: 2 | |
| swap целое число | успех | Размер подкачки в МБ. Пример: 100 | |
| is_public булево | успех | Сделать вкус доступным для общественности. Пример: True | |
| disk целое число | успех | Размер локального диска в ГБ. Пример: 10 | |
| id строка | успех | ID вкуса. Пример: 515256b8-7027-4d73-aa54-4e30a4a4a339 | |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантирует обратную совместимость.
Автор
- 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.5/modules/os_flavor_facts_module.html
