Jenkins版本升级要求输入初始管理员密码 如何跳过初始设置

触发原因 #

Jenkins升级过程中如果安装向导标记未被正确更新、旧配置读取失败，就会默认加载首次安装的管理员注册引导流程，不会直接读取已有的用户、角色配置。

操作步骤 #

• 先停掉正在运行的Tomcat服务，不要在服务运行状态下修改配置，避免出现文件读写冲突损坏配置。
• 对整个JENKINS_HOME目录做全量备份，防止操作失误丢失历史任务、用户权限等数据。Tomcat部署场景下JENKINS_HOME默认路径为启动Tomcat的系统用户家目录下的.jenkins文件夹，比如root用户启动Tomcat时，路径为/root/.jenkins。
• 进入JENKINS_HOME目录，编辑核心配置文件config.xml：
  • 找到installWizard配置项，将<installWizard>true</installWizard>修改为<installWizard>false</installWizard>，直接关闭安装向导触发开关
  • 找到useSecurity配置项，确认配置值为<useSecurity>true</useSecurity>，如果升级过程中该值被覆盖为false，直接改回true即可，该配置控制Jenkins是否开启登录鉴权
  • 注意：不要删除config.xml文件，该文件存储了Jenkins全局、权限、用户相关的所有核心配置，误删会导致所有历史配置完全重置
• 删除JENKINS_HOME目录下两个控制升级/安装向导状态的标记文件，避免版本校验逻辑重复触发引导流程，执行以下命令：

  rm -f jenkins.install.InstallUtil.lastExecVersion
  rm -f jenkins.install.UpgradeWizard.state
  

• 检查JENKINS_HOME目录权限，确保启动Tomcat的系统用户对该目录有完整读写权限——权限不足时Jenkins无法读取历史配置，会反复触发初始化流程。权限修正可参考命令：chown -R 你的tomcat启动用户:对应的用户组 /完整路径/到/jenkins_home
• 所有操作完成后重新启动Tomcat，再次访问Jenkins地址就会直接跳转到登录页，使用之前创建的管理员账号登录即可，原有角色分配、任务配置、构建历史都不会受影响。

内容的提问来源于stack exchange，提问作者Ash