Spec-Zone.ru › Ansible

community.general.vdo модуль – Модуль управления VDO

Примечание

Этот модуль является частью коллекции community.general (версия 9.5.0).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.general. Для использования этого модуля потребуются дополнительные требования, см. Требования для получения подробностей.

Чтобы использовать его в плейбуке, укажите: community.general.vdo.

  • Обзор
  • Требования
  • Параметры
  • Атрибуты
  • Примечания
  • Примеры

Обзор

  • Этот модуль управляет устройством дедупликации и сжатия VDO.
  • VDO, или Virtual Data Optimizer, — это целевой компонент device-mapper, который предоставляет возможности дедупликации, сжатия и разбиения блоков в режиме реального времени для первичного хранилища.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

  • PyYAML
  • kmod-kvdo
  • vdo

Параметры

Параметр

Комментарии

ackthreads

строка

Указывает количество потоков для подтверждения завершения запрошенных операций ввода/вывода VDO. Допустимые значения — целые числа от 1 до 100 (меньшие значения предпочтительнее из-за накладных расходов). По умолчанию значение равно 1. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное.

activated

логическое

Статус «активации» для тома VDO. Если это значение установлено в false, то том VDO не может быть запущен и не будет запускаться при запуске системы. Однако при первоначальном создании том VDO со значением «activated», установленным в «выкл.», будет работать, пока не будет остановлен. Это поведение по умолчанию команды «vdo create»; она предоставляет пользователю возможность записать базовый объем метаданных (файловая система, заголовки LVM и т. д.) на том VDO перед остановкой тома и деактивацией его до момента готовности к использованию.

Варианты:

  • false
  • true

biothreads

строка

Указывает количество потоков для отправки операций ввода/вывода на устройство хранения. Допустимые значения — целые числа от 1 до 100 (меньшие значения предпочтительнее из-за накладных расходов). По умолчанию значение равно 4. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное.

blockmapcachesize

строка

Объем памяти, выделенный для кэширования страниц карты блоков, в мегабайтах (или может быть указан с помощью суффикса LVM типа K, M, G или T). Значение по умолчанию (и минимальное) — 128M. Это значение определяет размер кэша; есть накладные расходы на использование памяти в 15%. Каждый 1,25 ГБ карты блоков охватывает 1 ТБ логических блоков, поэтому небольшой объем памяти кэша карты блоков может кэшировать значительный объем данных карты блоков. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное.

compression

строка

Настраивает включение сжатия. По умолчанию для созданного тома — «вкл.». Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное.

Варианты:

  • "disabled"
  • "enabled"

cputhreads

строка

Указывает количество потоков, используемых для работы, требующей больших вычислительных ресурсов ЦП, таких как хеширование или сжатие. Допустимые значения — целые числа от 1 до 100 (меньшие значения предпочтительнее из-за накладных расходов). По умолчанию значение равно 2. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное.

deduplication

строка

Настраивает включение дедупликации. По умолчанию для созданного тома — «вкл.». Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное.

Варианты:

  • "disabled"
  • "enabled"

device

строка

Полный путь к устройству для хранения VDO.

Это необходимо, если «state» равно «present».

emulate512

логическое

Включает режим эмуляции 512 байт, позволяющий драйверам или файловым системам обращаться к тому VDO с размером сектора 512 байт вместо стандартных 4096 байт. По умолчанию — «выкл.»; рекомендуется только тогда, когда драйвер или файловая система требуют доступа к устройству на уровне секторов размером 512 байт. Этот параметр доступен только при создании нового тома и не может быть изменен для существующего тома.

Варианты:

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

force

логическое

добавлено в community.general 2.4.0

При создании тома игнорирует любую существующую файловую систему или сигнатуру VDO, уже присутствующую на устройстве хранения. При остановке или удалении тома VDO сначала отключает файловую систему, хранящуюся на устройстве, если она подключена.

Предупреждение: Поскольку этот параметр отключает все проверки безопасности, важно убедиться, что все предоставленные параметры точны и намерены.

Варианты:

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

growphysical

логическое

Указывает, следует ли пытаться выполнить операцию growphysical, если на устройстве достаточно свободного места. Операция growphysical будет выполнена, если свободно места не менее 64 ГБ относительно предыдущего физического размера затронутого тома VDO.

Варианты:

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

indexmem

строка

Указывает объем индексной памяти в гигабайтах. По умолчанию значение равно 0,25. Можно использовать специальные десятичные значения 0,25, 0,5 и 0,75, а также любое положительное целое число. Этот параметр доступен только при создании нового тома и не может быть изменен для существующего тома.

indexmode

строка

Указывает режим индекса Albireo индекса. По умолчанию — «плотный» («dense»), у которого окно дедупликации — 1 ГБ индексной памяти на 1 ТБ входящих данных, требуя 10 ГБ индексных данных на постоянном хранилище. Режим «разреженный» («sparse») имеет окно дедупликации 1 ГБ индексной памяти на 10 ТБ входящих данных, но требует 100 ГБ индексных данных на постоянном хранилище. Этот параметр доступен только при создании нового тома и не может быть изменен для существующего тома.

Варианты:

  • "dense"
  • "sparse"

logicalsize

строка

Логический размер тома VDO (в мегабайтах или формате LVM-суффикса). Если для нового тома он не указан, по умолчанию он равен размеру базового устройства хранения, указанного в параметре «device». Существующие тома сохранят свой размер, если параметр «logicalsize» не указан или меньше или равен текущему размеру. Если указанный размер больше текущего размера, будет выполнена операция growlogical.

END_OF_DOCUMENT_MARKER

logicalthreads

string

Указывает количество потоков, на которые следует разделить части обработки VDO на основе логических адресов блоков. Допустимые значения — целые числа от 1 до 100 (меньшие числа предпочтительнее из-за накладных расходов). По умолчанию значение равно 1. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное значение.

name

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

Имя тома VDO.

physicalthreads

string

Указывает количество потоков, на которые следует разделить части обработки VDO на основе физических адресов блоков. Допустимые значения — целые числа от 1 до 16 (меньшие числа предпочтительнее из-за накладных расходов). Физическое пространство, используемое томом VDO, должно быть больше, чем (slabsize * physicalthreads). По умолчанию значение равно 1. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное значение.

readcache

string

Включает или отключает кэш чтения. По умолчанию значение ‘отключено’. Выбор ‘включено’ включает кэш чтения, что может повысить производительность для рабочих нагрузок с высокой дедупликацией, рабочих нагрузок чтения с высоким уровнем сжатия или на хранилищах жестких дисков. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное значение.

Функция кэширования чтения доступна в VDO 6.1 и более ранних версиях.

Варианты:

  • "disabled"
  • "enabled"

readcachesize

string

Указывает дополнительный размер кэша чтения устройства VDO в мегабайтах. Это дополнительно к минимальному системному значению. Использование значения с суффиксом K, M, G или T необязательно. Значение по умолчанию равно 0. 1,125 МБ памяти на поток био будет использоваться на каждый 1 МБ кэша чтения (например, том VDO, настроенный на 4 потока био, будет иметь накладные расходы на память кэша чтения в 4,5 МБ на каждый 1 МБ указанного кэша чтения). Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное значение.

Функция кэширования чтения доступна в VDO 6.1 и более ранних версиях.

running

boolean

Запущен ли этот том VDO.

Для запуска тома VDO необходимо его активировать.

Варианты:

  • false
  • true

slabsize

string

Размер приращения, на который увеличивается физический размер тома VDO, в мегабайтах (или может быть указан с суффиксом LVM типа K, M, G или T). Должен быть степенью двойки между 128 МБ и 32 ГБ. По умолчанию значение равно 2 ГБ, что поддерживает тома с физическим размером до 16 ТБ. Максимальное значение 32 ГБ поддерживает физический размер до 256 ТБ. Этот параметр доступен только при создании нового тома и не может быть изменен для существующего тома.

state

string

Должен ли этот том VDO быть «present» или «absent». Если для тома VDO «present» не существует, он будет создан. Если том VDO «present» уже существует, он будет изменён путём обновления конфигурации, которая вступит в силу при перезапуске тома VDO. Не все параметры существующего тома VDO могут быть изменены; список «statusparamkeys» содержит параметры, которые можно изменить после создания. Если тома VDO «absent» не существует, он не будет удалён.

Варианты:

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

writepolicy

string

Указывает политику записи для тома VDO. Режим ‘sync’ подтверждает записи только после того, как данные окажутся на стабильном хранилище. Режим ‘async’ подтверждает записи, когда данные были кэшированы для записи на стабильное хранилище. Режим по умолчанию (и рекомендуемый) ‘auto’ проверяет, поддерживает ли устройство хранения сбросы. Устройства, поддерживающие сбросы, приведут к тому, что том VDO будет в режиме ‘async’, а устройства, не поддерживающие сбросы, будут работать в режиме синхронизации. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное значение.

Варианты:

  • "async"
  • "auto"
  • "sync"

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: нет

Может работать в check_mode и возвращать прогноз о внесённых изменениях, не изменяя целевой объект.

diff_mode

Поддержка: нет

Возвратит подробности о том, что было изменено (или, возможно, нуждается в изменении в check_mode), при использовании режима diff.

Примечания

Примечание

  • В целом, следует использовать стандартную конфигурацию потоков.

Примеры

- name: Create 2 TB VDO volume vdo1 on device /dev/md0
  community.general.vdo:
    name: vdo1
    state: present
    device: /dev/md0
    logicalsize: 2T

- name: Remove VDO volume vdo1
  community.general.vdo:
    name: vdo1
    state: absent

Авторы

  • Bryan Gurney (@bgurney-rh)

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

  • Трекер задач
  • Репозиторий (источники)
  • Задать вопрос за помощью
  • Отправить сообщение об ошибке
  • Запросить новую функцию
  • Общение

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/vdo_module.html

Spec-Zone.ru

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