使用Helm升级Jenkins后HOME_DIR数据及管理员密码无法保留求助

使用jenkinsci/jenkins chart 4.7.2版本，执行helm upgrade -n jenkins jenkins -f values.yaml ./jenkins升级后，Jenkins HOME_DIR数据丢失，手动修改的管理员密码也被重置。当前PV和PVC均处于Bound状态。

解决步骤 #

• 确认PVC挂载路径一致性
  jenkinsci/jenkins chart默认将Jenkins HOME目录（/var/jenkins_home）与PVC挂载绑定。检查values.yaml中persistence配置的path参数与容器内路径一致，默认配置如下：

  persistence:
    enabled: true
    path: "/var/jenkins_home" # 请勿随意修改此路径，确保与容器内Jenkins HOME匹配
  

• 避免升级触发PVC重建
  若升级时修改了persistence中的storageClass、accessModes、size等核心参数，Helm会尝试重建PVC，导致原有PV数据丢失。确保values.yaml中这些参数与首次安装时的配置完全一致，不要随意变更。

• 排查管理员密码重置问题

  • 通过Jenkins界面修改的密码存储在/var/jenkins_home/users/admin目录下的配置文件中，若升级后密码被重置，优先确认PVC挂载是否生效。
  • 执行命令验证Pod内挂载情况：

    kubectl exec -n jenkins <jenkins-pod-name> -- df -h /var/jenkins_home
    

    确认输出为对应PV的存储，而非emptyDir临时存储。
  • 若values.yaml中配置了controller.adminPassword参数，升级时该参数会覆盖界面修改的密码。已手动修改密码的情况下，需删除values.yaml中的该参数，或同步更新为修改后的密码。

• 验证Pod存储挂载状态
  查看Jenkins Pod的挂载详情：

  kubectl describe pod -n jenkins <jenkins-pod-name>
  

  在Volumes和Mounts区域，确认/var/jenkins_home对应的是PVC jenkins，而非临时卷。

• 检查PV数据完整性
  进入Pod查看HOME目录内容，确认原有数据是否存在：

  kubectl exec -n jenkins <jenkins-pod-name> -- ls /var/jenkins_home
  

  若目录下没有users、jobs等原有数据，说明挂载未生效，需重新排查PVC和Pod的绑定关系。

内容的提问来源于stack exchange，提问作者K.k