3、Velero 插件机制详解

Velero 的插件体系是其扩展能力的核心。通过插件，Velero 能够对接不同的存储后端、快照系统，并在备份与恢复过程中注入自定义逻辑。理解插件类型、生命周期与注册方式，是开发自定义插件的基础。

3.1 插件类型

Velero 定义了四种标准插件类型，每种类型负责一个特定的扩展点。下表列出了这四种类型的核心职责与典型实现场景：

3.2 插件生命周期

每个 Velero 插件都遵循一个明确的生命周期，从注册到销毁。理解这一过程有助于正确实现插件接口并排查问题。

1. 初始化（Init）：Velero 服务启动时，扫描指定目录下的二进制插件文件，并通过 Go Plugin 系统加载。
2. 注册（Register）：插件调用 Register 方法，向 Velero 声明自己的类型、名称和优先级。
3. 调用（Invoke）：当备份或恢复流程触发时，Velero 根据事件类型调用对应插件的业务方法（如 Execute、CreateSnapshot）。
4. 销毁（Shutdown）：Velero 进程退出或插件被卸载时，执行清理逻辑。

下图展示了插件从加载到调用的完整生命周期流程：

3.3 插件注册方式

Velero 支持两种插件注册方式：进程内注册（In-Process）和进程外注册（Out-of-Process）。两种方式各有优劣，开发者可根据场景选择。

3.4 插件接口与实现示例

以 Restore Item Action 为例，其 Go 接口定义如下：

// RestoreItemAction 接口
type RestoreItemAction interface {
    // AppliesTo 返回该插件适用的资源
    AppliesTo() (ResourceSelector, error)
    // Execute 执行恢复时的自定义逻辑
    Execute(input *RestoreItemActionExecuteInput) (*RestoreItemActionExecuteOutput, error)
}

一个简单的进程外插件注册代码片段（Go 语言）：

func main() {
    // 创建插件实例
    plugin := &MyRestorePlugin{}
    // 注册到 Velero 插件系统
    pluginServer := veleroplugin.NewServer()
    pluginServer.RegisterRestoreItemAction("my-accelerator", plugin)
    // 启动 gRPC 服务
    pluginServer.Serve()
}

3.5 插件优先级与执行顺序

当多个插件匹配同一资源时，Velero 按照优先级排序执行。优先级是一个 0–100 的整数，数值越大执行顺序越靠前。

• Backup Item Action：优先级高的插件先执行，输出作为下一个插件的输入。
• Restore Item Action：优先级高的插件先执行，同样采用管道模式。

下图展示了多个 Restore Item Action 插件的执行顺序：