Spec-Zone.ru › Ansible

Модуль 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 — present.

ephemeral

integer

Размер эфемерного хранилища в ГБ.

extra_specs

dictionary

Словарь метаданных

id

псевдонимы: flavorid

string

Идентификатор вычислительного типа. Параметр необязателен: если значение не указано, будет назначен уникальный UUID.

Обратите внимание, что этот идентификатор используется только при первом создании вычислительного типа.

Идентификатор существующего вычислительного типа изменить нельзя.

Если для id задано значение auto, идентификатор будет сгенерирован автоматически. auto сохранён для обратной совместимости и будет удалён в следующем основном выпуске.

interface

псевдонимы: endpoint_type

string

Тип URL конечной точки, получаемой из каталога служб.

Варианты:

  • "admin"
  • "internal"
  • "public" ← (по умолчанию)

is_public

boolean

Сделать вычислительный тип общедоступным.

Варианты:

  • false
  • true

name

string / обязательный

Имя вычислительного типа.

ram

integer

Объём памяти в МБ.

Обязателен, если значение state — present.

region_name

string

Имя региона.

rxtx_factor

float

Коэффициент RX/TX.

sdk_log_level

string

Уровень журналирования OpenStackSDK

Варианты:

  • "INFO" ← (по умолчанию)
  • "DEBUG"

sdk_log_path

string

Путь к файлу журнала OpenStackSDK. Если значение пустое, журнал не ведётся.

state

string

Требуемое состояние ресурса.

Если state имеет значение present, необходимо указать параметры ram, vcpus и disk. Для этих параметров значения по умолчанию не заданы.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

swap

integer

Размер пространства подкачки в МБ.

timeout

integer

Время ожидания запрошенного ресурса со стороны Ansible.

По умолчанию: 180

validate_certs

псевдонимы: verify

boolean

Следует ли проверять запросы API SSL.

До Ansible 2.3 значение по умолчанию для этого параметра было true.

Варианты:

  • false
  • true

vcpus

integer

Количество виртуальных ЦП.

Обязателен, если значение state — present.

wait

boolean

Должен ли Ansible ожидать завершения операции с запрошенным ресурсом.

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Вместо явного указания значений можно использовать стандартные переменные окружения 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

Описание вычислительного типа

Возвращается: при успешном выполнении

Пример: "Example description"

disk

integer

Размер локального диска в ГБ.

Возвращается: при успешном выполнении

Пример: 10

ephemeral

integer

Размер эфемерного хранилища в ГБ.

Возвращается: при успешном выполнении

Пример: 10

extra_specs

dictionary

Метаданные вычислительного типа

Возвращается: при успешном выполнении

Пример: {"aggregate_instance_extra_specs:pinned": false, "quota:disk_read_iops_sec": 5000}

id

string

Идентификатор вычислительного типа.

Возвращается: при успешном выполнении

Пример: "515256b8-7027-4d73-aa54-4e30a4a4a339"

is_disabled

boolean

Признак того, что вычислительный тип отключён

Возвращается: при успешном выполнении

Пример: true

is_public

boolean

Сделать вычислительный тип общедоступным.

Возвращается: при успешном выполнении

Пример: true

name

string

Имя вычислительного типа.

Возвращается: при успешном выполнении

Пример: "tiny"

original_name

string

Имя этого вычислительного типа, возвращаемое командами списка или просмотра серверов

Возвращается: при успешном выполнении

ram

integer

Объём памяти в МБ.

Возвращается: при успешном выполнении

Пример: 1024

rxtx_factor

integer

Коэффициент масштабирования пропускной способности сети для этого вычислительного типа

Возвращается: при успешном выполнении

Пример: 100

swap

integer

Размер пространства подкачки в МБ.

Возвращается: при успешном выполнении

Пример: 100

vcpus

integer

Количество виртуальных ЦП.

Возвращается: при успешном выполнении

Пример: 2

Авторы

  • OpenStack Ansible SIG

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API