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). Значение по умолчанию (и минимальное) — 128М. Значение определяет размер кэша; есть накладные расходы на использование памяти в 15%. Каждые 1,25 ГБ карты блоков покрывают 1 ТБ логических блоков, поэтому небольшой объем кэша карты блоков может кэшировать значительное количество данных карты блоков. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано другое. | |
| compression |
| Настраивает, включено ли сжатие. Значение по умолчанию для созданного тома — «включено». Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано другое. |
| cputhreads | Указывает количество потоков, используемых для работы, интенсивной с точки зрения ЦП, такой как хэширование или сжатие. Допустимые значения — целые числа от 1 до 100 (меньшие числа предпочтительнее из-за накладных расходов). Значение по умолчанию — 2. Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано другое. | |
| deduplication |
| Настраивает, включена ли дедупликация. Значение по умолчанию для созданного тома — «включено». Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано другое. |
| device | Полный путь к устройству, используемому для хранения VDO. Требуется, если «state» равно «present». | |
| emulate512 bool |
| Включает режим эмуляции 512 байт, позволяя драйверам или файловым системам получать доступ к тому VDO с гранулярностью 512 байт вместо стандартной гранулярности 4096 байт. Значение по умолчанию — «выключено»; рекомендуется только тогда, когда драйвер или файловая система требуют доступа к устройству на уровне секторов по 512 байт. Этот параметр доступен только при создании нового тома и не может быть изменён для существующего тома. |
| growphysical bool |
| Указывает, следует ли выполнять операцию 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 МБ памяти на поток био будет использоваться на 1 МБ указанного размера кэша чтения (например, том VDO, настроенный на 4 потока био, будет иметь накладные расходы на использование памяти в кэше чтения в 4,5 МБ на 1 МБ указанного размера кэша чтения). Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано другое. | |
| running |
| Запущен ли данный том VDO. Для запуска тома VDO он должен быть активирован. |
| slabsize | Размер приращения, с которым увеличивается физический размер тома VDO, в мегабайтах (или может быть указан с постфиксом LVM: K, M, G или T). Должен быть степенью двойки от 128 МБ до 32 ГБ. Значение по умолчанию — 2 ГБ, что поддерживает тома с физическим размером до 16 ТБ. Максимальное значение 32 ГБ поддерживает физический размер до 256 ТБ. Этот параметр доступен только при создании нового тома и не может быть изменён для существующего тома. | |
| state обязательно |
| Должен ли этот том VDO быть «present» или «absent». Если тома VDO «present» не существует, он будет создан. Если том VDO «present» уже существует, он будет изменён путём обновления конфигурации, которая вступит в силу при перезапуске тома VDO. Не все параметры существующего тома VDO могут быть изменены; список «statusparamkeys» содержит параметры, которые могут быть изменены после создания. Если тома VDO «absent» не существует, он не будет удалён. |
| writepolicy |
| Указывает политику записи для тома VDO. Режим «sync» подтверждает записи только после того, как данные окажутся на стабильном хранилище. Режим «async» подтверждает записи, когда данные были кэшированы для записи на стабильное хранилище. Режим «auto» (по умолчанию и рекомендуемый) проверяет устройство хранения, чтобы определить, поддерживает ли оно сбросы. Устройства, которые поддерживают сбросы, приведут к тому, что том VDO будет в режиме «async», в то время как устройства, которые не поддерживают сбросы, будут работать в режиме «sync». Существующие тома сохранят ранее настроенное значение, если в плейбуке не указано другое. |
Примечания
Примечание
- В общем случае следует использовать стандартную конфигурацию потоков.
Примеры
# 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. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- 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.6/modules/vdo_module.html
