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. Если это значение установлено в Варианты:
|
biothreads строка | Указывает количество потоков для отправки операций ввода/вывода на устройство хранения. Допустимые значения — целые числа от 1 до 100 (меньшие значения предпочтительнее из-за накладных расходов). По умолчанию значение равно 4. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное. |
blockmapcachesize строка | Объем памяти, выделенный для кэширования страниц карты блоков, в мегабайтах (или может быть указан с помощью суффикса LVM типа K, M, G или T). Значение по умолчанию (и минимальное) — 128M. Это значение определяет размер кэша; есть накладные расходы на использование памяти в 15%. Каждый 1,25 ГБ карты блоков охватывает 1 ТБ логических блоков, поэтому небольшой объем памяти кэша карты блоков может кэшировать значительный объем данных карты блоков. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное. |
compression строка | Настраивает включение сжатия. По умолчанию для созданного тома — «вкл.». Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное. Варианты:
|
cputhreads строка | Указывает количество потоков, используемых для работы, требующей больших вычислительных ресурсов ЦП, таких как хеширование или сжатие. Допустимые значения — целые числа от 1 до 100 (меньшие значения предпочтительнее из-за накладных расходов). По умолчанию значение равно 2. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное. |
deduplication строка | Настраивает включение дедупликации. По умолчанию для созданного тома — «вкл.». Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное. Варианты:
|
device строка | Полный путь к устройству для хранения VDO. Это необходимо, если «state» равно «present». |
emulate512 логическое | Включает режим эмуляции 512 байт, позволяющий драйверам или файловым системам обращаться к тому VDO с размером сектора 512 байт вместо стандартных 4096 байт. По умолчанию — «выкл.»; рекомендуется только тогда, когда драйвер или файловая система требуют доступа к устройству на уровне секторов размером 512 байт. Этот параметр доступен только при создании нового тома и не может быть изменен для существующего тома. Варианты:
|
force логическое добавлено в community.general 2.4.0 | При создании тома игнорирует любую существующую файловую систему или сигнатуру VDO, уже присутствующую на устройстве хранения. При остановке или удалении тома VDO сначала отключает файловую систему, хранящуюся на устройстве, если она подключена. Предупреждение: Поскольку этот параметр отключает все проверки безопасности, важно убедиться, что все предоставленные параметры точны и намерены. Варианты:
|
growphysical логическое | Указывает, следует ли пытаться выполнить операцию growphysical, если на устройстве достаточно свободного места. Операция growphysical будет выполнена, если свободно места не менее 64 ГБ относительно предыдущего физического размера затронутого тома VDO. Варианты:
|
indexmem строка | Указывает объем индексной памяти в гигабайтах. По умолчанию значение равно 0,25. Можно использовать специальные десятичные значения 0,25, 0,5 и 0,75, а также любое положительное целое число. Этот параметр доступен только при создании нового тома и не может быть изменен для существующего тома. |
indexmode строка | Указывает режим индекса Albireo индекса. По умолчанию — «плотный» («dense»), у которого окно дедупликации — 1 ГБ индексной памяти на 1 ТБ входящих данных, требуя 10 ГБ индексных данных на постоянном хранилище. Режим «разреженный» («sparse») имеет окно дедупликации 1 ГБ индексной памяти на 10 ТБ входящих данных, но требует 100 ГБ индексных данных на постоянном хранилище. Этот параметр доступен только при создании нового тома и не может быть изменен для существующего тома. Варианты:
|
logicalsize строка | Логический размер тома VDO (в мегабайтах или формате LVM-суффикса). Если для нового тома он не указан, по умолчанию он равен размеру базового устройства хранения, указанного в параметре «device». Существующие тома сохранят свой размер, если параметр «logicalsize» не указан или меньше или равен текущему размеру. Если указанный размер больше текущего размера, будет выполнена операция growlogical. |
logicalthreads string | Указывает количество потоков, на которые следует разделить части обработки VDO на основе логических адресов блоков. Допустимые значения — целые числа от 1 до 100 (меньшие числа предпочтительнее из-за накладных расходов). По умолчанию значение равно 1. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное значение. |
name string / обязательно | Имя тома VDO. |
physicalthreads string | Указывает количество потоков, на которые следует разделить части обработки VDO на основе физических адресов блоков. Допустимые значения — целые числа от 1 до 16 (меньшие числа предпочтительнее из-за накладных расходов). Физическое пространство, используемое томом VDO, должно быть больше, чем (slabsize * physicalthreads). По умолчанию значение равно 1. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное значение. |
readcache string | Включает или отключает кэш чтения. По умолчанию значение ‘отключено’. Выбор ‘включено’ включает кэш чтения, что может повысить производительность для рабочих нагрузок с высокой дедупликацией, рабочих нагрузок чтения с высоким уровнем сжатия или на хранилищах жестких дисков. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное значение. Функция кэширования чтения доступна в VDO 6.1 и более ранних версиях. Варианты:
|
readcachesize string | Указывает дополнительный размер кэша чтения устройства VDO в мегабайтах. Это дополнительно к минимальному системному значению. Использование значения с суффиксом K, M, G или T необязательно. Значение по умолчанию равно 0. 1,125 МБ памяти на поток био будет использоваться на каждый 1 МБ кэша чтения (например, том VDO, настроенный на 4 потока био, будет иметь накладные расходы на память кэша чтения в 4,5 МБ на каждый 1 МБ указанного кэша чтения). Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное значение. Функция кэширования чтения доступна в VDO 6.1 и более ранних версиях. |
running boolean | Запущен ли этот том VDO. Для запуска тома VDO необходимо его активировать. Варианты:
|
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» не существует, он не будет удалён. Варианты:
|
writepolicy string | Указывает политику записи для тома VDO. Режим ‘sync’ подтверждает записи только после того, как данные окажутся на стабильном хранилище. Режим ‘async’ подтверждает записи, когда данные были кэшированы для записи на стабильное хранилище. Режим по умолчанию (и рекомендуемый) ‘auto’ проверяет, поддерживает ли устройство хранения сбросы. Устройства, поддерживающие сбросы, приведут к тому, что том VDO будет в режиме ‘async’, а устройства, не поддерживающие сбросы, будут работать в режиме синхронизации. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное значение. Варианты:
|
Атрибуты
Атрибут | Поддержка | Описание |
|---|---|---|
check_mode | Поддержка: нет | Может работать в |
diff_mode | Поддержка: нет | Возвратит подробности о том, что было изменено (или, возможно, нуждается в изменении в |
Примечания
Примечание
- В целом, следует использовать стандартную конфигурацию потоков.
Примеры
- 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
Ссылки на коллекции
© 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