Jenkins升级启动报错

发布于:2025-02-27 ⋅ 阅读:(13) ⋅ 点赞:(0)

前景

在执行Jenkins版本从2.378到2.499的升级过程中,访问时发生了异常。具体错误表现为:

  • 权限问题:部分用户在访问Jenkins界面时,遇到权限不足或授权失败的情况,可能由于新版本的权限模型或认证机制有所变化。
  • 插件兼容性:部分现有插件在新版本中未能正确加载或存在不兼容问题,导致界面加载失败或功能异常。
  • 配置变动:Jenkins核心或相关配置文件(如config.xmljenkins.yaml)中的某些参数在新版本中发生了变动,未能正确迁移,导致配置读取失败。
  • 依赖库问题:Jenkins升级过程中,可能存在某些外部依赖库的版本不兼容,导致部分功能无法正常运行。
  • 缓存与会话问题:升级后,Jenkins缓存未被清理,或用户会话状态未更新,导致用户无法重新登录或访问特定资源。

解决方法

仔细观察报错内容,进行分析:

1.CannotResolveClassException: 无法对这个类com.michelin.cio.hudson.plugins.rolestrategy.RoleBasedAuthorizationStrategy做正确的处理
2.CriticalXStreamException: XStream?? 这是在解析什么?? 解析文件??
3.Unable to read /usr/local/tomcat_Jenkins/code/config.xml: XStream在解析[config.xml]时遇到了无法处理的类[RoleBasedAuthorizationStrategy]

 此时你可能不会想到一个问题,就是config.xml里面有什么内容?不好意思,我就打开了这个文件观察了一下,结果恍然大悟。

config.xml文件的内容是下面这个样子的,你有没有发现什么呢?

<?xml version='1.1' encoding='UTF-8'?>
<hudson>
  <disabledAdministrativeMonitors/>
  <version>2.378</version>
  <numExecutors>2</numExecutors>
  <mode>NORMAL</mode>
  <useSecurity>true</useSecurity>
  <authorizationStrategy class="hudson.security.GlobalMatrixAuthorizationStrategy">
    <permission>hudson.model.Hudson.Administer:admin</permission>
    <permission>hudson.model.Hudson.Read:authenticated</permission>
    <permission>hudson.model.Item.Build:authenticated</permission>
    <permission>hudson.model.Item.Read:authenticated</permission>
  </authorizationStrategy>
  <securityRealm class="hudson.security.HudsonPrivateSecurityRealm">
    <disableSignup>true</disableSignup>
    <enableCaptcha>false</enableCaptcha>
  </securityRealm>
  <disableRememberMe>false</disableRememberMe>
  <projectNamingStrategy class="jenkins.model.ProjectNamingStrategy$DefaultProjectNamingStrategy"/>
  <workspaceDir>${JENKINS_HOME}/workspace/${ITEM_FULL_NAME}</workspaceDir>
  <buildsDir>${ITEM_ROOTDIR}/builds</buildsDir>
  <markupFormatter class="hudson.markup.EscapedMarkupFormatter"/>
  <jdks/>
  <viewsTabBar class="hudson.views.DefaultViewsTabBar"/>
  <myViewsTabBar class="hudson.views.DefaultMyViewsTabBar"/>
  <clouds/>
  <scmCheckoutRetryCount>0</scmCheckoutRetryCount>
  <views>
    <hudson.model.AllView>
      <owner class="hudson" reference="../../.."/>
      <name>all</name>
      <description>测试环境Jenkins部署打包</description>
      <filterExecutors>false</filterExecutors>
      <filterQueue>false</filterQueue>
      <properties class="hudson.model.View$PropertyList"/>
    </hudson.model.AllView>
    <listView>
      <owner class="hudson" reference="../../.."/>
      <name>测试</name>
      <description>杰西卡测试环境</description>
      <filterExecutors>false</filterExecutors>
      <filterQueue>false</filterQueue>
      <properties class="hudson.model.View$PropertyList"/>
      <jobNames>
        <comparator class="java.lang.String$CaseInsensitiveComparator"/>
        <string>aitrick_pre</string>
        <string>aitrick_static_aitracking</string>
        <string>aitrick_test</string>
        <string>aitrick_test_admin</string>
        <string>cprice-new-admin</string>
        <string>cprice-new-compile</string>
        <string>cprice-new-deploy</string>
        <string>xiyou_admin_api_deploy</string>
        <string>xiyou_api_deploy</string>
        <string>xiyou_compile</string>
        <string>xiyou_web_static</string>
      </jobNames>
      <jobFilters/>
      <columns>
        <hudson.views.StatusColumn/>
        <hudson.views.WeatherColumn/>
        <hudson.views.JobColumn/>
        <hudson.views.LastSuccessColumn/>
        <hudson.views.LastFailureColumn/>
        <hudson.views.LastDurationColumn/>
        <hudson.views.BuildButtonColumn/>
        <jenkins.branch.DescriptionColumn plugin="branch-api@2.5.6"/>
      </columns>
      <recurse>false</recurse>
    </listView>
  </views>
  <primaryView>all</primaryView>
  <slaveAgentPort>-1</slaveAgentPort>
  <label></label>
  <crumbIssuer class="hudson.security.csrf.DefaultCrumbIssuer">
    <excludeClientIPFromCrumb>false</excludeClientIPFromCrumb>
  </crumbIssuer>
  <nodeProperties/>
  <globalNodeProperties/>
  <nodeRenameMigrationNeeded>true</nodeRenameMigrationNeeded>
</hudson>

从文件内容可以看出,这里面有权限插件模块的部分定义,你会发现报错的类就在xml定义了。
因为插件被卸载,这部分定义内容还在,所以启动也就出大问题。
只需要删除<authorizationStrategy>...</authorizationStrategy>这部分内容,jenkins就可以重新启动起来啦。

问题解决了,继续权限管理的设置就正常了。