如何将 Jenkins 从一台 PC 移动到另一台 PC答案

【问题标题】：How to move Jenkins from one PC to another如何将 Jenkins 从一台 PC 移动到另一台 PC
【发布时间】：2012-02-02 05:46:37
【问题描述】：

我目前在我的开发 PC 上使用 Jenkins。我将它安装在我的开发 PC 上，因为我对这个工具的了解有限；所以我在我的开发PC上对其进行了测试。现在，我对 Jenkins 作为我在构建过程中的长期“合作伙伴”感到满意，并希望将此 Jenkins “移动”到专用服务器。

在此之前，我已经完成了一些构建，并从每个构建中存档了工件。特别是，内部版本号对我来说对于版本控制非常重要。

如何将所有 Jenkins 信息从我当前的 PC 导出到我的新服务器？

【问题讨论】：

我刚做了这个。我按照 Cédric Julien 的回答中的步骤进行操作，但我发现在 Windows 上，我必须先运行修复安装，然后 Jenkins 才能在移动后成功启动。修复后一切正常。

标签： jenkins data-migration

【解决方案1】：

假设我们正在将 Jenkins LTS 从 PC1 迁移到 PC2（LTS 版本与升级相同）。使用ThinBackUp插件实现Jenkins版本的迁移或升级，非常方便。

第 1 步：准备 PC1 进行迁移

管理 Jenkins -> ThinbackUp -> 设置
选择正确的选项和目录进行备份
如果您需要作业历史记录并且需要添加工件，请同时选择“Back build results”选项。

返回点击立即备份。

注意：此 Thinbackup 还将采用可选的插件备份。

检查 ThinbackUp 文件夹必须有一个包含当前日期和时间戳的文件夹。（等待几分钟，可能需要一些时间。）
您已准备就绪，将其压缩并复制到 PC2 中的 PARTICULAR（将是“备份目录”）目录。
解压 ThinbackUp 压缩文件夹。
停止 PC1 中的 Jenkins 服务。

第二步： 在 PC2 中安装 Jenkins（使用 .war 文件或粘贴存档版本安装）。

使用命令sc create <Jenkins_PC2Servicename> binPath="<Path_to_Jenkinsexe>/jenkins.exe" 创建 Jenkins 服务
如果需要，在 PC2 中修改 JENKINS_HOME/jenkins.xml。
在 PC2 中运行 windows 服务
管理 Jenkins -> ThinbackUp -> 设置
确保将步骤 1 中的特殊路径作为 ThinBackup 设置中的备份目录。
ThinbackUp -> 恢复会给你一个下拉列表，选择正确的备份（用日期和时间戳标识）。

等待几分钟，您将获得最新的备份配置，包括 PC2 中的作业历史记录和插件。
如果 JENKINS_HOME/Jenkins.xml 中需要其他更改（来自不需要的 PC1 ThinbackUp），则需要手动进行此修改。

注意：如果您在 Jenkins 作业中使用 SCM 的数据库设置，那么您需要格外小心，因为所有 SCM 插件不支持借助 ThinbackUp 插件进行数据库设置。例如如果您正在使用 PTC Integrity SCM 插件，并且某些 Jenkins 作业正在使用使用 Integrity 的数据库，那么它将创建一个目录 JENKINS_Home/IntegritySCM，ThinbackUp 在备份时不会包含此数据库。

解决方案：直接将这个JENKINS_Home/IntegritySCM文件夹从PC1复制到PC2。

【讨论】：

【解决方案2】：

如果您的 JENKINS_HOME 目录太大而无法复制，而您只需要设置相同的作业、Jenkins 插件和 Jenkins 配置（并且不需要旧的作业工件和报告），那么你可以使用ThinBackup Plugin:

在源和目标 Jenkins 服务器上安装 ThinBackup
在两者上配置备份目录（在 Manage Jenkins → ThinBackup → Settings）
在源 Jenkins 上，转到 ThinBackup → 立即备份
从Jenkins源备份目录复制到Jenkins目标备份目录
在目标 Jenkins 上，进入 ThinBackup → Restore，然后重启 Jenkins 服务。
如果缺少某些插件或作业，请将备份内容直接复制到目标 JENKINS_HOME。
如果您在源 Jenkins 上进行了用户身份验证，但现在锁定在目标 Jenkins 上，则编辑 Jenkins config.xml，将 <useSecurity> 设置为 false，然后重新启动 Jenkins。

【讨论】：

为什么 JENKINS_HOME 目录太大而无法复制？我们在谈论什么样的尺寸？
我的 jenkins_home 是 100Gb 左右，不想将它复制到新服务器，因为它大多是扔掉的东西
我的 Jenkins_home 约为 4TB，因此仅包含配置且没有构建历史记录或 /usercontent 的精简副本是有用的。
感谢 @halfer 指出这一点，但我相信 SO 最初是为技术答案而设计的。只要我的答案是明确的（代表点表明它是） - 在没有技术改进的情况下修复语法，即使不是滥用也是一件麻烦事。
我将它回滚到固定版本。它进行了许多非装饰性的修复并提高了可读性。请不要在没有充分理由重新引入错别字的情况下回滚。谢谢。

【解决方案3】：

有时我们可能无法访问 Jenkins 机器来将文件夹直接复制到另一个 Jenkins 实例中。所以我编写了一个菜单驱动的实用程序，它使用 Jenkins REST API 调用将插件和作业从一个 Jenkins 实例安装到另一个实例。

插件迁移：

GET 请求：{SOURCE_JENKINS_SERVER}/pluginManager/api/json?depth=1 将为您提供与其版本一起安装的插件列表。

您可以发送带有以下参数的 POST 请求来安装这些插件。

final_url=`{DESTINATION_JENKINS_SERVER}/pluginManager/installNecessaryPlugins`

data=`<jenkins><install plugin="{PLUGIN_NAME}@latest"/></jenkins>` (where, latest will fetch the latest version of the plugin_name)

auth=`(destination_jenkins_username, destination_jenkins_password)`

header=`{crumb_field:crumb_value,"Content-Type":"application/xml”}` (where crumb_field=Jenkins-Crumb and get crumb value using API call {DESTINATION_JENKINS_SERVER}/crumbIssuer/api/json

对于工作迁移：

您可以使用 REST 调用 {SOURCE_JENKINS_URL}/view/All/api/json 获取安装在 {SOURCE_JENKINS_URL} 上的作业列表
然后您可以使用作业 URL {SOURCE_JENKINS_URL}/job/{JOB_NAME} 从 {SOURCE_JENKINS_URL} 上的作业中获取每个作业 config.xml 文件。
使用此 config.xml 文件在 {DESTINATION_JENKINS_URL} 上发布 XML 文件的内容，这将在 {DESTINATION_JENKINS_URL} 上创建一个作业。

我在 Python 中创建了一个菜单驱动的实用程序，它要求用户启动插件或 Jenkins 迁移并使用 Jenkins REST API 调用来执行此操作。

您可以从此网址引用JenkinsMigration.docx jenkins jenkinsmigration jenkinsrestapi

【讨论】：

虽然此链接可能会回答问题，但最好在此处包含答案的基本部分并提供链接以供参考。如果链接页面发生变化，Link-only 的答案可能会失效。

【解决方案4】：

Jenkins 服务器自动化：

第 1 步：

设置一个存储库以将 Jenkins 主页（作业、配置、插件等）存储在 GitLab 本地或 GitHub 私有存储库中，并通过推送对 Jenkins 作业、插件等的任何新更改来定期更新。

第 2 步：

为 Jenkins 配置一个 Puppet 主机组/角色，可用于启动新的 Jenkins 服务器。在 Puppet 配方中进行所有基本配置，并确保它安装最新版本的 Jenkins 并为 JENKINS_HOME 设置单独的目录/挂载。

第 3 步：

使用上面的 Jenkins-puppet 配置启动一台新机器。安装完所有内容后，将 Jenkins 配置从 Git 存储库抓取/克隆到 Jenkins 主目录并重新启动 Jenkins。

第 4 步：

转到 Jenkins URL，Manage Jenkins → Manage Plugins 并更新所有需要更新的插件。

完成

您可以使用Docker Swarm 或Kubernetes 来自动扩展从节点。

【讨论】：

【解决方案5】：

按照Jenkins wiki，您必须：

在新服务器上安装新的 Jenkins 实例
确保新旧 Jenkins 实例均已停止
归档旧 Jenkins 实例的 JENKINS_HOME 的所有内容
将存档解压到新的 JENKINS_HOME 目录中
启动新的 Jenkins 实例
不要忘记将文档/链接更改为新的 Jenkins 实例 :)
不要忘记更改新 Jenkins 文件的所有者：chown -R jenkins:jenkins $JENKINS_HOME

JENKINS_HOME 在 Linux 安装中默认位于 ~/.jenkins，但要准确找到它的位置，请转到 http://your_jenkins_url/configure 页面并检查第一个参数的值：Home directory；这是 JENKINS_HOME。

【讨论】：

当我启动我的新 jenkins 时，我的节点显示出来了，这是正确的。但是当我点击某个节点时，那里的 URL 指向旧 jenkins，如下所示：从从属命令行运行：javaws old-jenkins-server:8080/computer/slaveMachine1/slave-agent.jnlp 或者如果从属是无头的：java -jar slave.jar -jnlpUrl old-jenkins-server:8080/computer/slaveMachine1/slave-agent.jnlp 现在我应该怎么做让每个节点的这些 URL 指向 new-jenkins-server？
得到了我之前评论中提到的问题的解决方案：转到管理 Jenkins > 配置系统。在“Jenkins 位置”部分的“Jenkins URL”字段下，更改 URL 以将其指向新的 jenkins 服务器。
确保也复制隐藏文件夹！
哈哈 +1 “不要忘记更改文档/链接到您的新 Jenkins 实例”
我在正确的文件权限和所有权方面遇到了问题，为了解决这个问题，我使用了这个 docker 脚本（设置所有权/权限的部分）：hub.docker.com/r/appcontainers/jenkins/~/dockerfile

【解决方案6】：

这对我从 Ubuntu 12.04（Jenkins 版本 1.628）迁移到 Ubuntu 16.04（Jenkins 版本 1.651.2）很有帮助。我先installed Jenkins from the repositories。

Stop both Jenkins servers
将JENKINS_HOME（例如/var/lib/jenkins）从旧服务器复制到新服务器。从新服务器中的控制台：

rsync -av username@old-server-IP:/var/lib/jenkins/ /var/lib/jenkins/
Start your new Jenkins server

你可能不需要这个，但我必须

Manage Jenkins 和 Reload Configuration from Disk。
断开并重新连接所有从站。
检查Configure System > Jenkins Location 中的Jenkins URL 是否已正确分配给新的Jenkins 服务器。

【讨论】：

新的 Jenkins 和旧的版本一样吗？
@JakubCzaplicki - 两个 Jenkins 都是 1.6，但版本不完全相同。答案已更新。然后我将 Ubuntu 16.04 更新为 Jenkins 2.6，替换了 jenkins.war 文件，它运行良好。 stackoverflow.com/questions/11062335/…
完成上述操作并访问/configureSecurity我得到java.lang.AssertionError: InstanceIdentity is missing its singleton
@maxisme，迟到了，但这个帖子表明你提到的问题与 java 版本有关。 issues.jenkins-ci.org/browse/JENKINS-46182