Ark/Velero 定时备份调度删除指南:`ark schedule delete` 命令详解
Ark/Velero 定时备份调度删除指南:ark schedule delete 命令详解
ark schedule delete 是 Ark(Velero 前身,v0.4.0 时代命令名为 ark,后续版本更名为 velero)中用于删除定时备份调度(Schedule)的 CLI 命令。本指南以 site/content/docs/v0.4.0/cli-reference/ark_schedule_delete.md 为骨架,结合当前仓库源码中该命令的实现细节,完整讲解其语法、选项、执行流程与实战用法,帮助读者安全、精准地清理不再需要的定时备份任务。
命令概述:删除一个定时备份调度
在 Ark/Velero 的备份体系中,Schedule 是一种声明式的定时备份策略:用户通过 cron 表达式指定备份的执行周期,由服务端的 schedule 控制器周期性地为其生成 Backup 对象。当某个定时备份策略不再需要时,可以通过 ark schedule delete 将其删除。
该命令的核心作用只有一个:从集群中删除指定的 Schedule 资源,使对应的定时备份不再被触发。命令语法如下:
ark schedule delete NAME [flags]
其中 NAME 为待删除的调度名称,[flags] 为该命令可用的命令行选项。命令删除成功后不会输出复杂结果,仅返回成功或错误信息。
在 v0.4.0 的命令树中,ark schedule delete 是 ark schedule 的子命令。参考文档 ark_schedule.md 显示,ark schedule 下同时挂有 create(创建调度)、delete(删除调度)、get(查看调度)三个子命令,分别对应调度的完整生命周期管理。
命令选项详解
本命令专属选项
v0.4.0 参考文档中,ark schedule delete 仅暴露一个选项:
-h, --help help for delete
-h, --help 用于输出该命令的帮助信息。这说明在 v0.4.0 时代,删除调度只支持按名称逐个指定,功能较为朴素。
从父命令继承的全局选项
ark schedule delete 还继承了 ark 根命令及父命令的日志与连接配置项,这些选项在 ark.md 与 ark_schedule.md 中均有声明:
| 选项 | 默认值 | 说明 |
|---|---|---|
--alsologtostderr |
关闭 | 同时将日志输出到标准错误(stderr)与日志文件 |
--kubeconfig string |
空 | 连接 Kubernetes API Server 所使用的 kubeconfig 文件路径;若未设置,依次尝试环境变量 KUBECONFIG 与集群内配置(in-cluster configuration) |
--log_backtrace_at traceLocation |
:0 |
当日志命中 file:N 位置时,输出堆栈回溯信息 |
--log_dir string |
空 | 指定日志文件写入目录;非空时启用文件日志 |
--logtostderr |
关闭 | 仅将日志输出到标准错误,不写文件 |
--stderrthreshold severity |
2 |
达到或超过该级别的日志同时写入 stderr,severity 取值对应 INFO=0、WARNING=1、ERROR=2、FATAL=3 |
-v, --v Level |
0 |
设置 V 级别日志的详细程度 |
--vmodule moduleSpec |
空 | 按 pattern=N 的逗号分隔列表,对指定文件设置日志级别过滤 |
其中 --kubeconfig 是最常用的连接类选项:当默认的 KUBECONFIG 环境变量不可用或需要操作其他集群时,可通过它显式指定配置文件。
实战用法:从 v0.4.0 到当前版本的完整删除方式
v0.4.0 文档给出的用法是 ark schedule delete NAME。而从当前仓库源码 pkg/cmd/cli/schedule/delete.go 的实现看,该命令在后续版本中已演进为支持多种删除模式的完整形态,其 Example 字段展示了官方推荐的各类用法:
删除单个调度(基础用法,v0.4.0 即支持):
ark schedule delete schedule-1
免确认删除:
velero schedule delete schedule-1 --confirm
默认执行删除前会弹出交互式确认(详见下文"执行流程"),--confirm 可跳过该提示,适合在脚本或 CI/CD 流水线中自动化执行。
一次删除多个调度:
velero schedule delete schedule-1 schedule-2
命令接受多个 NAME 参数,逐一进行删除。
按标签选择器批量删除:
velero schedule delete --selector foo=bar
删除全部调度:
velero schedule delete --all
现代实现中,--selector 与 --all 属于批量删除能力,其参数校验逻辑在 pkg/cmd/cli/select_option.go 中定义:Validate() 通过 xor 逻辑强制要求"指定名称、--all、--selector"三者中恰好指定一种,否则返回错误 you must specify exactly one of: specific schedule name(s), the --all flag, or the --selector flag。这一设计避免了两者混用导致的行为歧义。
底层执行流程解析
从当前仓库源码看,ark schedule delete 的删除动作由 pkg/cmd/cli/schedule/delete.go 中的 Run 函数驱动,其完整流程可分为四个阶段:
第一步:交互确认(安全护栏)
if !o.Confirm && !confirm.GetConfirmation() {
return nil
}
若未指定 --confirm,命令会在终端输出 Are you sure you want to continue (Y/N)? 等待用户输入。确认逻辑实现在 pkg/cmd/util/confirm/confirm.go 中:读取用户输入并循环校验,输入 y(不区分大小写)返回 true 继续删除,输入 n 直接终止,任何其他输入会重新询问。用户选择否定时命令静默退出,不做任何删除操作。
第二步:确定待删除的调度集合
命令通过 switch 分支决定获取对象的方式:
- 当指定了名称参数时,逐个调用
Client.Get按{Namespace, Name}从集群获取 Schedule 对象,获取失败的名称会被收集为错误并跳过; - 未指定名称时(即使用
--all或--selector),通过Client.List结合标签选择器列出命名空间下的调度;未提供选择器则使用labels.Everything()匹配全部。
第三步:执行删除
对获取到的每个 Schedule 对象调用 Client.Delete,删除成功的对象输出 Schedule deleted: <name>;单个对象的删除失败不会中断其余对象的删除,而是被收集到错误列表中。
第四步:汇总错误
全部处理完毕后,若存在错误则通过 kubeerrs.NewAggregate 聚合返回;若初始即未找到任何调度,则输出 No schedules found 并正常返回,不会报错。这一行为在 pkg/cmd/cli/backup/delete.go 中也有对应实现,说明该模式在 backup、restore、schedule 等多个删除命令间是复用的。
删除调度的后续影响:备份是否会被清理?
这是实践中最容易被忽略的问题,需要区分两类对象:
1. 已生成的 Backup 不受影响。 删除 Schedule 只移除"定时触发"这一行为,Schedule 在存续期间已经创建出来的 Backup 对象仍会完整保留,其对应的备份数据(对象存储中的文件与卷快照)不会因调度删除而丢失。若要清理这些历史备份,需要另行使用 ark backup delete(现代版本中可用 velero backup delete --selector velero.io/schedule-name=schedule-1 按调度名标签批量删除,见 pkg/cmd/cli/backup/delete.go 的示例)。
2. 服务端控制器会感知调度消失。 从当前仓库源码 pkg/controller/schedule_controller.go 的 Reconcile 逻辑可以推断:当调度对象被删除后,控制器在获取对象时得到 NotFound 错误,会记录日志并从监控指标中移除该调度的信息,随后结束本次协调。因此删除调度后,服务端会自然停止为其生成新的 Backup,无需额外操作。
相关命令速览
ark schedule delete 与同一命令树下的其他子命令配合,构成完整的调度生命周期管理:
- ark schedule create:创建定时备份调度,核心参数包括
--schedule(cron 表达式,必填)、--include-namespaces(默认备份全部命名空间,默认值*)、--snapshot-volumes(是否对 PersistentVolume 做快照,默认true)以及--ttl(备份可被垃圾回收前的时间,默认24h0m0s); - ark schedule get:查看现有调度列表,支持
-l, --selector按标签过滤、-o, --output切换table/json/yaml输出格式; - ark schedule:上述子命令的父命令,入口为
ark schedule; - ark:根命令,描述为"Back up and restore Kubernetes cluster resources",统一管理 backup、restore、schedule、server、version 等子命令。
需要说明的是,v0.4.0 参考文档反映的是项目早期(Heptio Ark 时期)的命令形态,彼时命令仅支持按名称删除且无 --confirm 等选项;当前仓库源码 pkg/cmd/cli/delete/delete.go 显示该命令已演进为同时管理 backup、backup-location、restore、schedule 四类资源的 delete 命令族,并为 schedule 单独保留了 --confirm、--all、--selector 与多名称支持,安全性(交互确认)与批量运维能力(选择器、全量删除)均得到显著增强。