• Introduction
• Environment
• Resolution

Introduction

The CloudBees CI release 2.277.1.2 includes the five important changes listed below. The upgrade process from a version minor than 2.277.1.2 should be addressed considering the content of these KB articles.

• [CloudBees CI 2.277.1.2] Replace Acegi Security with Spring Security & upgrade Spring Framework
• [CloudBees CI 2.277.1.2] JENKINS-56109: Change Jenkins configuration UI from tables to divs
• [CloudBees CI 2.277.1.2] JEP-228: Unforking XStream
• [CloudBees CI 2.277.1.2] jQuery 3.5.x Upgrade
• [CloudBees CI 2.277.1.2] ASM Upgrade

Environment

All these changes are present since the 2.277.1 line in all products listed below. Issues might be seen when you upgrade from a version prior to CloudBees CI 2.277.1.

• CloudBees CI (CloudBees Core) - 2.277.1
• CloudBees CI (CloudBees Core) on modern cloud platforms - Managed controller - 2.277.1
• CloudBees CI (CloudBees Core) on modern cloud platforms - Operations Center - 2.277.1
• CloudBees CI (CloudBees Core) on traditional platforms - Client controller - 2.277.1
• CloudBees CI (CloudBees Core) on traditional platforms - Operations Center - 2.277.1
• CloudBees Jenkins Platform - Client controller - 2.277.1
• CloudBees Jenkins Platform - Operations Center - 2.277.1
• CloudBees Jenkins Platform - Client controller - 2.277.1
• CloudBees Jenkins Platform - Operations Center - 2.277.1
• CloudBees Jenkins Platform - Client controller - 2.277.1
• CloudBees Jenkins Platform - Operations Center - 2.277.1
• CloudBees Jenkins Distribution - 2.277.1
• CloudBees Jenkins Enterprise - 1.11.45
• Jenkins LTS - 2.277.1

Resolution

As a general rule, to avoid any issues related to any of these changes, it is suggested to:
1. Make sure Beekeeper is configured to upgrade CAP plugins. For this, ensure that the option Manage Jenkins » Beekeeper Upgrade Assistant » CAP Configuration » Allow automatic upgrades of plugins on restart is enabled
2. Upgrade all the plugins listed under Manage Jenkins » Manage Plugins (Updates tab) except for the cas-plugin.

NOTE

The cas-plugin must be upgraded at the same time as the instance. This means that once the service is stopped, you will need to download the plugin and manually replace $JENKINS_HOME/plugins/cas-plugin.jpi. For further assistance, please, open a support ticket.

If you follow this simple rule about upgrading all the plugins before addressing the upgrade of the CloudBees CI release 2.277.1.2, then you will minimize the risk of a failed upgrade. However, there are still some plugins which are known to be incompatible, or whose status is unknown. Therefore, some of the KBs contains Groovy scripts, to be executed under Manage Jenkins » Script Console, which will give a full picture about what might fail in case you upgrade. Most of the incompatible plugins have not been fixed because are not maintained at this moment.

CloudBees provides Assisted Updates for further guidance in case you are not used to upgrade your instances.

In case of any question about this upgrade, don’t hesitate to open a support case and ask for help.