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