Поддержка отслеживания измененных блоков (CBT) для драйверов CSI была выпущена в статусе Alpha в сентябре 2025 года. С выходом версии v1.0.0 проекта external-snapshot-metadata в марте 2026 года эта функция перешла в статус Beta.
Если вы еще не знакомы с отслеживанием измененных блоков для хранилищ в Kubernetes, в анонсе Alpha-версии описаны мотивация, три основных компонента (gRPC-сервис CSI SnapshotMetadata, SnapshotMetadataService CRD и sidecar-контейнер external-snapshot-metadata), а также приведено руководство по использованию API. В настоящее время CBT применяется к блочным томам; отслеживание списка изменений для файловых томов и сетевых файловых ресурсов этой функцией не охватывается. В этой статье основное внимание уделяется различиям в бета-версии.
Что нового в бета-версии
Основным изменением в этом релизе стало повышение версии SnapshotMetadataService CRD с v1alpha1 до v1beta1. CRD, используемый для анонсирования сервиса метаданных драйвера, теперь обслуживает cbt.storage.k8s.io/v1beta1. Сама схема осталась без изменений, но в этом релизе была удалена версия v1alpha1 (вместо того чтобы поддерживать ее параллельно с новой версией). Если вы обновляетесь с Alpha-версии, вам необходимо:
- Повторно применить определение CRD, поставляемое с версией v1.0.0.
- Обновить манифесты SnapshotMetadataService, чтобы использовать apiVersion: cbt.storage.k8s.io/v1beta1.
- Обновить любой клиентский код или код контроллера, взаимодействующий с CRD.
Это разовое изменение. Автоматическое преобразование между двумя версиями не предусмотрено.
Совместимость
- Минимальная версия Kubernetes: 1.33
- Спецификация CSI: 1.10 или новее
- Образ контейнера: registry.k8s.io/sig-storage/csi-snapshot-metadata:v1.0.0
Начало работы
Раздел «Начало работы» в блоге об Alpha-версии по-прежнему актуален. Вкратце:
- Убедитесь, что ваш драйвер CSI поддерживает снимки томов и использует sidecar-контейнер external-snapshot-metadata.
- Установите CRD SnapshotMetadataService (определение v1beta1 из релиза v1.0.0).
- Создайте ресурс SnapshotMetadataService для вашего драйвера.
- Используйте клиент — snapshot-metadata-lister или собственную реализацию — для вызова GetMetadataAllocated и GetMetadataDelta.
Если вы хотите увидеть полный процесс от начала до конца, пример драйвера hostpath станет хорошей отправной точкой.
Что дальше?
Основное внимание в оставшейся части бета-цикла будет уделено более широкому внедрению драйверов CSI и сбору отзывов об эксплуатации перед переходом функции к статусу GA. Если вы поддерживаете драйвер CSI, сейчас самое время оценить возможность добавления поддержки. Если вы создаете приложение для резервного копирования на основе этого API, отзывы о потоковых клиентах и пакете итератора будут очень полезны.
Где можно узнать больше?
- Документация разработчика CSI по метаданным снимков.
- KEP-3314.
- Репозиторий external-snapshot-metadata.
- Схема gRPC.
- Пример клиента snapshot-metadata-lister.
Как принять участие?
Эта работа является результатом вклада многих людей из SIG Storage. Огромное спасибо всем, кто помогал рецензировать, писать код и тестировать функцию на этапах Alpha и Beta:
- Ben Swartzlander (bswartz)
- Carl Braganza (carlbraganza)
- Daniil Fedotov (hairyhum)
- Ivan Sim (ihcsim)
- Nikhil Ladha (Nikhil-Ladha)
- Praveen M (iPraveenParihar)
- Rakshith R (Rakshith-R)
- Xing Yang (xing-yang)
Если вы хотите принять участие в работе над CSI или хранилищами в Kubernetes, SIG Storage — лучшее место для начала. Рабочая группа по защите данных (Data Protection Working Group) также проводит регулярные встречи, и новым участникам всегда рады.
