Jenkins - 备份插件

Jenkins - 备份策略

备份您的 Jenkins 控制器（Jenkins controller）对于防止数据丢失和确保在发生故障时能够快速恢复至关重要。备份内容包括配置、作业定义、构建历史、插件和凭据（secrets）等。

理解 JENKINS_HOME

最重要的目录是 JENKINS_HOME。此目录包含了 Jenkins 所需要的一切：系统配置、插件配置、作业定义、构建记录、日志、凭据、工作空间（workspaces）（尽管这些通常可以重建）等等。该位置显示在 Manage Jenkins（管理 Jenkins）→ System（系统设置）页面（在“主目录”下）。

备份方法 1：直接备份 JENKINS_HOME

最全面的方法是定期备份整个 JENKINS_HOME 目录。这可以捕获 Jenkins 的完整状态。

优点： 完整备份，概念相对简单。
缺点： 可能很大（特别是构建历史/构建产物很多时），需要停止 Jenkins 或小心处理文件锁以确保一致性备份，恢复需要替换整个目录。
方法： 使用标准备份工具（如 rsync、tar、商业备份软件、文件系统快照（filesystem snapshots）（如果可用））将 JENKINS_HOME 目录复制到安全位置（例如，不同的服务器、网络存储、云存储）。定期安排此任务（例如，每晚）。

通常建议排除 caches、logs 以及可能包括 workspaces 等子目录，以减小备份大小，因为这些目录通常可以重新生成。

备份方法 2：使用备份插件

有几种插件可以帮助备份关键配置文件，这比管理整个 JENKINS_HOME 目录更简单。

ThinBackup 插件

‘ThinBackup’ 插件是备份基本配置的常用选择：

步骤 1：安装插件。转到 Manage Jenkins（管理 Jenkins）→ Plugins（插件管理）→ Available Plugins（可用插件）。搜索“ThinBackup”并安装。如果提示，请重启 Jenkins。

步骤 2：配置备份设置。转到 Manage Jenkins（管理 Jenkins）→ ThinBackup → Settings（设置）。

备份目录 (Backup directory)： 指定一个在您 JENKINS_HOME 之外的路径，用于存储备份。
备份计划 (Backup schedule)： 定义一个 cron 表达式（cron expression），用于自动备份（例如，H H * * * 表示每天）。
最大备份数量 (Max number of backups)： 配置备份保留策略。
包含/排除文件 (Files to include/exclude)： 自定义要备份的内容（通常包括全局配置、作业配置、用户内容、插件、凭据、节点）。通常默认值就很好，但如果构建记录过大或恢复时不需要，您可以将其排除。
备份构建结果 (Backup build results)： 选择是否包含构建历史记录（这会显著增加备份大小）。

步骤 3：手动备份（可选）。您可以从 ThinBackup 主界面点击“Backup Now”（立即备份）来手动触发备份。

步骤 4：恢复。转到 Manage Jenkins（管理 Jenkins）→ ThinBackup → Restore（恢复）。从列表中选择一个备份日期，然后点击“Restore”（恢复）。恢复后需要重启 Jenkins。

缺点： 可能无法捕获所有内容（例如，详细的构建日志/构建产物（artifacts），除非特别配置），依赖于插件功能。

备份方法 3：配置即代码 (CasC)

现代方法将 Jenkins 配置本身视为代码，存储在版本控制系统（如 Git）中。

Jenkins 配置即代码 (JCasC) 插件： 在存储于 Git 中的 YAML 文件中定义 Jenkins 系统配置（安全性、工具、插件、云）。Jenkins 在启动时或通过重新加载自动应用此配置。
Job DSL 插件： 使用 Groovy 脚本定义 Jenkins 作业（Freestyle、Pipeline、Multi-branch），脚本也存储在 Git 中。一个“种子作业”（seed job）读取这些脚本并创建/更新实际的 Jenkins 作业。
Jenkinsfile 中定义的 Pipeline： 直接将您的构建/测试/部署逻辑存储在应用程序源代码仓库（repository）中的 Jenkinsfile 文件中，这意味着 Pipeline 定义本身是版本化的，并随您的代码一起备份。

缺点： 不备份运行时数据（构建历史、不由 CasC 管理的凭据、除非外部管理的用户账户）。需要学习 CasC/Job DSL 语法。仍需要单独备份凭据和潜在的关键构建历史记录。