Модуль openstack.cloud.compute_flavor — управление вычислительными типами OpenStack
Примечание
Этот модуль входит в коллекцию openstack.cloud (версия 2.5.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install openstack.cloud. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: openstack.cloud.compute_flavor.
Краткое описание
- Добавление и удаление вычислительных типов в OpenStack.
- Обновление вычислительного типа включает его удаление и повторное создание.
Требования
На хосте, на котором выполняется этот модуль, должны быть установлены следующие компоненты.
- python >= 3.6
- openstacksdk >= 1.0.0
Параметры
Параметр | Комментарии |
|---|---|
api_timeout integer | Время ожидания сокетного уровня перед завершением вызовов API по тайм-ауту. Если параметр не указан, библиотеке requests ничего не передаётся. |
auth dictionary | Словарь со сведениями для аутентификации, необходимыми выбранному облачному плагину аутентификации. Для используемого по умолчанию плагина password здесь указываются auth_url, username, password, project_name и сведения о доменах (например, user_domain_name или project_domain_name), если облако их поддерживает. Для других плагинов этот параметр должен содержать все параметры, необходимые соответствующему плагину аутентификации. Этот параметр не нужен, если указано именованное облако или заданы переменные окружения OpenStack OS_*. |
auth_type string | Имя используемого плагина аутентификации. Если облако использует не парольную аутентификацию, здесь следует указать имя плагина и соответствующим образом заполнить параметр auth. |
ca_cert псевдонимы: cacert string | Путь к пакету сертификатов CA, который можно использовать для проверки запросов API SSL. |
client_cert псевдонимы: cert string | Путь к сертификату клиента, используемому при SSL-соединении. |
client_key псевдонимы: key string | Путь к ключу клиента, используемому при SSL-соединении. |
cloud any | Именованное облако или конфигурация облака, с которыми выполняются операции. Если cloud — строка, она указывает на конфигурацию именованного облака, определённую в файле OpenStack clouds.yaml. Задаёт значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан auth или заданы переменные окружения OpenStack OS_*. Если cloud — словарь, он содержит полную конфигурацию облака, аналогичную разделу файла clouds.yaml. |
description string | Описание вычислительного типа. |
disk integer | Размер локального диска в ГБ. Обязателен, если значение state — |
ephemeral integer | Размер эфемерного хранилища в ГБ. |
extra_specs dictionary | Словарь метаданных |
id псевдонимы: flavorid string | Идентификатор вычислительного типа. Параметр необязателен: если значение не указано, будет назначен уникальный UUID. Обратите внимание, что этот идентификатор используется только при первом создании вычислительного типа. Идентификатор существующего вычислительного типа изменить нельзя. Если для id задано значение |
interface псевдонимы: endpoint_type string | Тип URL конечной точки, получаемой из каталога служб. Варианты:
|
is_public boolean | Сделать вычислительный тип общедоступным. Варианты:
|
name string / обязательный | Имя вычислительного типа. |
ram integer | Объём памяти в МБ. Обязателен, если значение state — |
region_name string | Имя региона. |
rxtx_factor float | Коэффициент RX/TX. |
sdk_log_level string | Уровень журналирования OpenStackSDK Варианты:
|
sdk_log_path string | Путь к файлу журнала OpenStackSDK. Если значение пустое, журнал не ведётся. |
state string | Требуемое состояние ресурса. Если state имеет значение Варианты:
|
swap integer | Размер пространства подкачки в МБ. |
timeout integer | Время ожидания запрошенного ресурса со стороны Ansible. По умолчанию: |
validate_certs псевдонимы: verify boolean | Следует ли проверять запросы API SSL. До Ansible 2.3 значение по умолчанию для этого параметра было Варианты:
|
vcpus integer | Количество виртуальных ЦП. Обязателен, если значение state — |
wait boolean | Должен ли 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 RAM, 1 vCPU, 10GB disk, 10GB ephemeral
openstack.cloud.compute_flavor:
cloud: mycloud
state: present
name: tiny
ram: 1024
vcpus: 1
disk: 10
ephemeral: 10
description: "I am flavor mycloud"
- 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 dictionary | Словарь с описанием вычислительного типа. Возвращается: при успешном выполнении, если state имеет значение ‘present’ |
|
description string |
Описание вычислительного типа Возвращается: при успешном выполнении Пример: |
|
disk integer |
Размер локального диска в ГБ. Возвращается: при успешном выполнении Пример: |
|
ephemeral integer |
Размер эфемерного хранилища в ГБ. Возвращается: при успешном выполнении Пример: |
|
extra_specs dictionary |
Метаданные вычислительного типа Возвращается: при успешном выполнении Пример: |
|
id string |
Идентификатор вычислительного типа. Возвращается: при успешном выполнении Пример: |
|
is_disabled boolean |
Признак того, что вычислительный тип отключён Возвращается: при успешном выполнении Пример: |
|
is_public boolean |
Сделать вычислительный тип общедоступным. Возвращается: при успешном выполнении Пример: |
|
name string |
Имя вычислительного типа. Возвращается: при успешном выполнении Пример: |
|
original_name string |
Имя этого вычислительного типа, возвращаемое командами списка или просмотра серверов Возвращается: при успешном выполнении |
|
ram integer |
Объём памяти в МБ. Возвращается: при успешном выполнении Пример: |
|
rxtx_factor integer |
Коэффициент масштабирования пропускной способности сети для этого вычислительного типа Возвращается: при успешном выполнении Пример: |
|
swap integer |
Размер пространства подкачки в МБ. Возвращается: при успешном выполнении Пример: |
|
vcpus integer |
Количество виртуальных ЦП. Возвращается: при успешном выполнении Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/openstack/cloud/compute_flavor_module.html