Velero升级至1.13.1版本后CSI卷快照功能故障排查指南

问题背景

在Kubernetes集群备份工具Velero从1.8.0版本升级到1.13.1版本后，用户遇到了持久卷(PV)快照功能失效的问题。该问题主要表现为备份过程中无法正确创建CSI卷快照，系统报错提示缺少VolumeSnapshotClass资源或相关配置不正确。

核心问题分析

升级后出现的问题主要源于Velero 1.13.1版本对CSI快照功能的实现方式发生了变化。新版本要求：

1. 必须为每个StorageClass创建对应的VolumeSnapshotClass
2. VolumeSnapshotClass需要正确配置驱动程序和删除策略
3. 需要特别注意标签配置以支持默认快照类选择

详细解决方案

VolumeSnapshotClass配置要求

在新版本中，VolumeSnapshotClass的配置变得更为严格。以下是一个针对AWS EBS存储的正确配置示例：

apiVersion: snapshot.storage.k8s.io/v1
kind: VolumeSnapshotClass
metadata:
  name: csi-aws-vsc-ebs
  labels:
    velero.io/csi-volumesnapshot-class: "true"
driver: ebs.csi.aws.com
deletionPolicy: Delete

关键配置说明：

• driver字段必须与StorageClass中的provisioner完全匹配
• deletionPolicy可根据需求设置为Delete或Retain
• 标签velero.io/csi-volumesnapshot-class: "true"用于标记默认快照类

多存储类环境配置

当集群中存在多种存储类型时，需要为每种存储类型创建对应的VolumeSnapshotClass：

1. AWS EBS存储：

apiVersion: snapshot.storage.k8s.io/v1
kind: VolumeSnapshotClass
metadata:
  name: csi-aws-vsc-ebs
driver: ebs.csi.aws.com
deletionPolicy: Delete

2. AWS EFS存储：

apiVersion: snapshot.storage.k8s.io/v1
kind: VolumeSnapshotClass
metadata:
  name: csi-aws-vsc-efs
driver: efs.csi.aws.com
deletionPolicy: Retain

3. 传统AWS EBS存储(k8s原生)：

apiVersion: snapshot.storage.k8s.io/v1
kind: VolumeSnapshotClass
metadata:
  name: csi-k8s-vsc-ebs
driver: kubernetes.io/aws-ebs
deletionPolicy: Delete

多存储类环境下的标签策略

在多存储类环境中，关于velero.io/csi-volumesnapshot-class标签的使用有特殊要求：

1. 如果只有一个VolumeSnapshotClass，可以保留该标签作为默认选择
2. 如果有多个VolumeSnapshotClass，应该移除该标签，让Velero根据StorageClass自动匹配对应的VolumeSnapshotClass
3. 可以通过备份注解显式指定使用的VolumeSnapshotClass

常见错误及解决方法

错误1：缺少VolumeSnapshotClass

错误信息：

failed to get volumesnapshotclass for provisioner ebs.csi.aws.com

解决方案： 创建与StorageClass匹配的VolumeSnapshotClass，确保driver字段与StorageClass的provisioner一致。

错误2：快照超时

错误信息：

Timed out awaiting reconciliation of volumesnapshot

解决方案：

1. 检查CSI驱动是否正常运行
2. 确认VolumeSnapshotClass的配置正确
3. 检查云提供商API限流情况
4. 适当增加Velero的等待超时时间

错误3：资源不存在

错误信息：

the server could not find the requested resource

解决方案：

1. 确认已安装VolumeSnapshot CRD
2. 检查Kubernetes版本是否支持所需的API版本(v1beta1或v1)

版本升级注意事项

从Velero 1.8升级到1.13时，需要特别注意以下变化：

1. CSI插件从v1beta1迁移到了v1 API版本
2. 快照功能实现更加严格，配置要求更高
3. 多存储环境下的处理逻辑有所变化

建议升级前：

1. 备份现有配置
2. 查阅版本变更说明
3. 在测试环境先行验证

最佳实践建议

1. 命名规范：保持VolumeSnapshotClass与对应StorageClass命名一致，便于管理
2. 标签策略：在复杂环境中避免使用默认标签，采用显式指定方式
3. 测试验证：升级后先进行小规模备份恢复测试
4. 监控设置：配置适当的监控告警，及时发现备份失败情况
5. 文档记录：详细记录存储配置和快照策略，便于后续维护

通过以上配置和注意事项，可以确保Velero在升级后能够正确执行CSI卷快照功能，保障Kubernetes集群数据的可靠备份。