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

Примечание

Этот плагин входит в коллекцию community.general (версия 1.3.2).

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

Примечания

Примечание

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

Примеры

- 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/vdo_module.html