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

Примечание

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

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в playbook, укажите: 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 строка		Указывает количество потоков, используемых для ресурсоемких задач, таких как хэширование или сжатие. Допустимые значения — целые числа от 1 до 100 (меньшие числа предпочтительны из-за накладных расходов). Значение по умолчанию — 2. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано другое значение.
deduplication строка	Варианты: disabled enabled	Настройка включения или выключения дедупликации. Значение по умолчанию для создаваемого тома — 'enabled'. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано другое значение.
device строка		Полный путь к устройству для хранения VDO. Требуется, если «state» — «present».
emulate512 логическое	Варианты: no ← yes	Включает режим эмуляции 512 байт, позволяя драйверам или файловым системам получать доступ к тому VDO с гранулярностью 512 байт вместо стандартной гранулярности 4096 байт. Значение по умолчанию — «выкл.»; рекомендуется только в случае, если драйвер или файловая система требуют доступа на уровне сектора 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	Включает или отключает кэш чтения. Значение по умолчанию — «выкл.». Выбор «вкл.» включает кэш чтения, что может улучшить производительность для рабочих нагрузок с высокой дедупликацией, операций чтения с высокой степенью сжатия или на жестких дисках. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано другое значение. Функция кэша чтения доступна в VDO 6.1 и более ранних версиях.
readcachesize строка		Указывает дополнительный размер кеша чтения устройства VDO в мегабайтах. Это дополнительно к минимальному размеру, определенному системой. Использование значения с постфиксом K, M, G или T необязательно. Значение по умолчанию — 0. 1,125 МБ памяти на поток bio будут использоваться на 1 МБ указанного кеша чтения (например, том VDO, настроенный на 4 потока bio, будет иметь накладные расходы на использование памяти кеша чтения в 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/vdo_module.html