Velero备份EFS卷时遇到的VolumeSnapshotClass问题解析

问题背景

在使用Velero进行Kubernetes集群备份时，特别是针对AWS EFS(Elastic File System)卷进行文件系统备份(FSB)时，用户遇到了一个常见但令人困惑的问题：系统错误地要求提供VolumeSnapshotClass，而实际上EFS并不支持CSI快照功能。

问题现象

当用户尝试执行包含EFS卷的备份操作时，Velero返回了如下错误信息：

failed to get VolumeSnapshotClass for StorageClass cloudbees-efs-cloudbees-ci-persistence: 
error getting VolumeSnapshotClass: failed to get VolumeSnapshotClass for provisioner efs.csi.aws.com

值得注意的是，这个错误出现在多个持久卷声明(PVC)上，特别是那些绑定但未直接附加到任何Pod的EFS卷。

技术分析

Velero备份机制

Velero提供了两种主要的卷备份方式：

1. CSI卷快照：依赖于存储提供商实现的CSI驱动和VolumeSnapshotClass
2. 文件系统备份(FSB)：使用Kopia或Restic直接将卷内容备份到对象存储

对于EFS这类不支持快照的共享文件系统，理论上应该只使用FSB方式。

问题根源

经过深入分析，发现问题出在以下方面：

1. 孤立PVC处理：Velero对未绑定到任何Pod的PVC(孤立PVC)会尝试使用CSI快照方式备份，即使启用了FSB
2. EFS限制：AWS EFS CSI驱动不支持创建快照，因此当Velero尝试为孤立PVC创建快照时失败
3. 配置误解：用户同时启用了CSI功能(EnableCSI)和FSB，导致处理逻辑复杂化

解决方案

针对这一问题，我们推荐以下几种解决方案：

方案一：排除孤立PVC

通过Velero的备份策略排除那些不需要备份的孤立PVC：

velero create backup <backup-name> --exclude-resources persistentvolumeclaims

方案二：禁用CSI功能

如果确定只使用FSB，可以在Velero配置中禁用CSI功能：

configuration:
  features: ""

方案三：明确指定备份方式

为特定PVC明确指定备份方式，可以通过以下两种方法实现：

1. 使用注解：在PVC上添加注解指定使用FSB

   annotations:
     velero.io/backup-volumes: "true"
   

2. 使用VolumePolicy：在备份时指定卷策略文件

方案四：排除Velero命名空间

Velero自身的维护作业(repo-maintain-job)不需要备份，排除后可避免相关警告：

velero create backup <backup-name> --exclude-namespaces velero

最佳实践建议

1. 备份前检查：执行备份前检查PVC状态，确保所有需要备份的PVC都正确绑定到Pod
2. 明确备份策略：根据存储类型明确选择CSI快照或FSB，避免混合使用
3. 定期验证：定期验证备份的完整性和可恢复性
4. 日志监控：监控Velero备份日志，及时发现和处理异常情况

总结

Velero在备份EFS卷时要求VolumeSnapshotClass的问题，本质上是因为对孤立PVC的处理逻辑与EFS功能限制之间的不匹配。通过理解Velero的备份机制和EFS的特性，我们可以采取针对性的配置策略来避免这一问题，确保备份操作顺利完成。

对于使用AWS EFS的用户，建议优先考虑纯FSB方案，并通过适当的排除策略避免不必要的CSI快照尝试，这样可以获得更稳定可靠的备份体验。