vdo - Модуль управления VDO
Новая версия 2.5.
Обзор
- Этот модуль управляет устройством дедупликации и сжатия VDO. VDO, или Виртуальный Оптимизатор Данных, это целевой модуль, который предоставляет возможности дедупликации, сжатия и тонкого разбиения блоков в режиме реального времени для первичного хранилища.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- PyYAML
- kmod-kvdo
- vdo
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| ackthreads | Указывает количество потоков, используемых для подтверждения завершения запрошенных операций ввода-вывода VDO. Допустимые значения — целые числа от 1 до 100 (меньшие числа предпочтительнее из-за накладных расходов). Значение по умолчанию — 1. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное. | |
| activated |
| Статус «активации» тома VDO. Если значение установлено в «нет», тома VDO нельзя запустить, и он не запустится при запуске системы. Однако при первоначальном создании тома VDO со значением «activated», установленным в «выкл», он будет работать, пока не будет остановлен. Это поведение по умолчанию команды «vdo create»; оно предоставляет пользователю возможность записать базовый объём метаданных (файловая система, заголовки LVM и т. д.) в том VDO до остановки тома и его деактивации до готовности к использованию. |
| biothreads | Указывает количество потоков, используемых для отправки операций ввода-вывода на устройство хранения. Допустимые значения — целые числа от 1 до 100 (меньшие числа предпочтительнее из-за накладных расходов). Значение по умолчанию — 4. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное. | |
| blockmapcachesize | Объём памяти, выделенной для кэширования страниц карты блоков, в мегабайтах (или может быть указан с суффиксом LVM типа K, M, G или T). Значение по умолчанию (и минимальное) — 128M. Значение указывает размер кэша; есть накладные расходы на использование памяти в 15%. Каждый 1,25 Гб карты блоков охватывает 1 ТБ логических блоков, поэтому небольшой объём памяти кэша карты блоков может кэшировать значительный объём данных карты блоков. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное. | |
| compression |
| Настраивает, включено ли сжатие. Значение по умолчанию для созданного тома — «включено». Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное. |
| cputhreads | Указывает количество потоков, используемых для CPU-ёмких задач, таких как хэширование или сжатие. Допустимые значения — целые числа от 1 до 100 (меньшие числа предпочтительнее из-за накладных расходов). Значение по умолчанию — 2. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное. | |
| deduplication |
| Настраивает, включено ли дедуплицирование. Значение по умолчанию для созданного тома — «включено». Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное. |
| device | Полный путь к устройству для хранения VDO. Требуется, если «state» — «present». | |
| emulate512 |
| Включает эмуляцию 512-байтового режима, позволяя драйверам или файловым системам получить доступ к томам VDO с разрешением 512 байт вместо стандартного разрешения 4096 байт. Значение по умолчанию — «выключено»; рекомендуется только в том случае, если драйвер или файловая система требуют доступа на уровне сектора 512 байт к устройству. Этот параметр доступен только при создании нового тома и не может быть изменён для существующего. |
| 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 | Указывает количество потоков, по которым делятся части обработки VDO на основе логических адресов блоков. Допустимые значения — целые числа от 1 до 100 (меньшие числа предпочтительнее из-за накладных расходов). Значение по умолчанию — 1. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное. | |
| name обязательно | Имя тома VDO. | |
| physicalthreads | Указывает количество потоков, по которым делятся части обработки VDO на основе физических адресов блоков. Допустимые значения — целые числа от 1 до 16 (меньшие числа предпочтительнее из-за накладных расходов). Физическое пространство, используемое томом VDO, должно быть больше (slabsize * physicalthreads). Значение по умолчанию — 1. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное. | |
| readcache |
| Включает или отключает кэш чтения. Значение по умолчанию — «выключено». Выбор «включено» включает кэш чтения, что может улучшить производительность для рабочих нагрузок с высокой дедупликацией, рабочих нагрузок чтения с высоким уровнем сжатия или на устройствах хранения на жёстких дисках. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное. |
| readcachesize | Указывает дополнительный размер кэша чтения устройства VDO в мегабайтах. Кроме этого, используется минимально необходимое значение, определённое системой. Использование значений с суффиксами K, M, G или T необязательно. Значение по умолчанию — 0. 1,125 МБ памяти на поток bio будет использоваться на 1 МБ указанного кэша чтения (например, для тома VDO, настроенного на 4 потока bio, накладные расходы на использование памяти кэша чтения будут составлять 4,5 МБ на 1 МБ указанного кэша чтения). Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное. | |
| running |
| Запущен ли этот том VDO. Том VDO должен быть активирован, чтобы его можно было запустить. |
| slabsize | Размер приращения, с помощью которого увеличивается физический размер тома VDO, в мегабайтах (или может быть указан с суффиксом LVM типа K, M, G или T). Должен быть степенью двойки в диапазоне от 128M до 32G. Значение по умолчанию — 2G, которое поддерживает тома с физическим размером до 16T. Максимальное значение 32G поддерживает физический размер до 256T. Этот параметр доступен только при создании нового тома и не может быть изменён для существующего. | |
| state обязательно |
| Должен ли этот том VDO быть «present» или «absent». Если «present» тома VDO не существует, он будет создан. Если «present» тома VDO уже существует, он будет изменён путём обновления конфигурации, которая вступит в силу при перезапуске тома VDO. Не все параметры существующего тома VDO могут быть изменены; список «statusparamkeys» содержит параметры, которые можно изменить после создания. Если «absent» тома VDO не существует, он не будет удалён. |
| writepolicy |
| Указывает политику записи тома VDO. Режим «sync» подтверждает записи только после того, как данные окажутся в стабильном хранилище. Режим «async» подтверждает записи после того, как данные были помещены в кэш для записи в стабильное хранилище. Режим по умолчанию (и рекомендуемый) «auto» проверяет устройство хранения, чтобы определить, поддерживает ли оно операции сброса. Устройства, поддерживающие операции сброса, приведут к тому, что том VDO будет в режиме «async», в то время как устройства, не поддерживающие сбросы, будут работать в режиме синхронизации. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано иное. |
Примечания
Примечание
- В целом, следует использовать конфигурацию потоков по умолчанию.
Примеры
# Create a VDO volume
- name: Create 2 TB VDO volume vdo1 on device /dev/md0
vdo:
name: vdo1
state: present
device: /dev/md0
logicalsize: 2T
# Remove a VDO volume
- name: Remove VDO volume vdo1
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.5/modules/vdo_module.html
