Ark/Velero 定时备份调度删除指南:`ark schedule delete` 命令详解

原创2026-09-15 17:48:541,693 阅读
文章标签:云原生容器编排灾备存储备份恢复CLI运维高可用

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 与多名称支持,安全性(交互确认)与批量运维能力(选择器、全量删除)均得到显著增强。

登录后查看全文
velero