CloudBees CI release highlights

What’s new in CloudBees CI 2.440.3.7

Watch video

New Features

HashiCorp Vault AWS credentials now supported

The CloudBees HashiCorp Vault plugin now supports AWS credentials.


HashiCorp Vault GitHub App credentials now supported

The CloudBees HashiCorp Vault plugin now supports Vault GitHub App credentials.

Feature Enhancements

Configuration as Code Plugin Management 2.0

The new API version of the CasC Plugin Management offers a smoother experience for users configuring their instances using Configuration as Code and performing activities around plugin management.

The API v2 of Plugin Management improves the user experience by:

  • Simplifying the usage of the plugin.yaml and plugin catalog files

  • Calculating and downloading hard dependencies for listed plugins

  • Generating a report of that lists all installed plugins

Reduction of plugin catalog use in benefit of plugins.yaml file Plugins to install are now all listed in the plugins.yaml file. The Plugin Catalog is only needed for pinning plugin versions.

The listed plugins can be retrieved in different ways:

  • From the Update Center with no additional configuration. This is the default method.

  • From a URL using the proper credentials (if needed).

  • Using Maven GAV coordinates from a repository. The repository configuration is also part of the plugins.yaml file.

  • From a local filesystem.

Dependency Calculation Dependencies are now managed by CasC for CAP and non-CAP plugins. CasC installs all mandatory dependencies for CAP and non-CAP plugins listed in the plugins.yaml file

CasC Plugin Report When you configure your CloudBees CI instance using CasC, a CasC plugin report with all the effectively installed plugins is created in the plugin-installation-report.json file within your $JENKINS_HOME folder.


Added an administrative monitor to warn about usage of CloudBees High Availability retention strategy on inbound agents.

The CloudBees High Availability (HA) retention strategy is only supported for outbound agents (for example, using SSH). It is not supported for inbound agents.

An administrative monitor will be displayed when any agent is incorrectly configured, and a migration task will revert the retention strategy of the impacted agents to "Always".


Display an administrative monitor when the High Availability (HA) setting of maximum load per replica has been exceeded

In a High Availability (HA) controller, it is possible to configure a maximum load per replica that will cause new queue items to be rejected. When the controller has reached that threshold, it now displays an administrative monitor that notes this fact.


CloudBees Pipeline Explorer Feature Enhancements

The CloudBees Pipeline Explorer now uses a special icon for the input steps in the tree view, and displays them in all cases. Also, when an input step is waiting for input, the banner at the top of the CloudBees Pipeline Explorer is now highlighted to draw more attention to it.

Updates have been made to the header and users can now configure the build details display.


Include information about agent launches from other High Availability (HA) replicas in support bundles

The list of support components included in a High Availability (HA) controller now includes the missing log files from the agent launches.


Administrative Monitor is shown if there are non-recoverable errors when checking out controller bundles

A new Administrative Monitor is shown if there are non-recoverable errors when checking out the controller bundles.


Forbid updating credentials ID in CyberArk, HashiCorp Vault and restricted credentials providers

Duplicate IDs in credentials could result in the deletion of incorrect credentials. This fix forbids the creation of credentials with similar IDs.


Blue Ocean removal

Blue Ocean plugins will soon be removed from CAP. Customers are advised to use CloudBees Pipeline Explorer instead.

Resolved Issues

Pipeline Template Catalogs fail to load

After upgrading to CloudBees CI version 2.440.2.1, the global Pipeline Template Catalogs fail to load with a CannotResolveClassException: globalTemplateCatalogManagement. The issue has been fixed.


Fixed excessive memory usage by the Plugin Usage Analyzer plugin

The Plugin Usage Analyzer had a flaw where it held on to all of the Pipeline runs that it wanted to analyze before performing the analysis of their usage. This caused CloudBees CI to use an excessive amount of memory when the analysis was running. This is now fixed by the Plugin Usage Analyzer plugin only holding in memory the pipeline runs of the current pipeline that is being analyzed (a maximum of 5).


Changed Configuration as Code (CasC) item export download icon

The download icon was small and hard to find. It was changed to a standard Download button.


CloudBees Pipeline Explorer Resolved Issues
  • CloudBees Pipeline Explorer did not support non-default values for the crumb request field for POST requests Previously, if you modified the default crumb request field, some features in the CloudBees Pipeline Explorer did not work correctly. This included the abort and rebuild buttons and the ability to save user preferences. This issue has been resolved.

  • Build artifacts panel displays an incorrect action button The "Build artifacts" drawer now dynamically loads the correct information.

  • The "Show node steps in tree" preference in the CloudBees Pipeline Explorer always resets to false after a controller restart The "Show node steps in tree" preference in the CloudBees Pipeline Explorer always reset to false after a controller restart. The preference now maintains its configured value across restarts. This issue has been resolved.

  • CloudBees Pipeline Explorer shows redundant context badges in the log view between lines from steps from the same stage If two steps in a stage have more than one line of consecutive log output, the CloudBees Pipeline Explorer shows a redundant context badge between them. Since they are from the same stage, you do not have to display a badge. This issue has been resolved.

  • The "Show steps in stage" feature did not work correctly in the CloudBees Pipeline Explorer The “Show steps in stage“ menu option for stages in the tree view only showed steps that were immediate children of the selected stage, instead of showing all descendant steps as intended. This issue has been resolved.

  • Users' Console URL provider set on a controller could be reset after synchronization with the operations center If a plugin provides an alternate Console URL provider that is only installed on the controller, but not on the operations center, then the Users' Console URL provider settings that are set on the controllers with values provided by that plugin could be reset after synchronization with the operations center.

    This behavior is now corrected.


Fixed AggregatedResultsIcons when security was enabled

If a folder was using AggregatedResultsIcons and the CloudBees CI instance was using any security realm, the icons were not visible.

Now, the icons are visible.


Error during startup when running standalone controller without operations-center-client enabled

When disabling the operations-center-client plugin in a standalone controller (where it is not useful), an error was displayed during startup related to the header text retrieval. This is now suppressed.


Errors when disabling operations-center-client plugin in a standalone High Availability (HA) controller

A standalone controller does not require the operations-center-client plugin. However, if this were disabled in a High Availability (HA) controller, several errors were repeatedly printed to the system log and certain functionality, such as load balancing, did not work.


High Availability (HA) script console ran scripts as an anonymous user

The High Availability (HA) script console did not work for scripts that required a particular CloudBees CI authentication; for example, to look up a project by name. Now, the Groovy script will run under the logged in user’s authentication.


High Availability (HA) Groovy library migration could break checkout by tag

An administrative monitor on a High Availability (HA) controller warns you if you have configured a Pipeline library to check out to a shared location, and offers to migrate the configuration to use a per-build checkout, including optimizations for the clone technique. If there is a library configured with plain Git, after migration it was not possible to clone a library by tag (as opposed to branch) unless the configurations were manually adjusted to include tags in the advanced clone options. Now the clone options will include tags. The behavior is unchanged for derivative Git-based configurations; at least the GitHub Branch Source plugin is able to clone a library by tag even with clone options suppressing the tag retrieval, since the refspec in that case encodes the tag name.


Silence warnings in a system log for fields with no getters

Periodically, in the logs of a controller, a warning is emitted related to a missing getter. The warnings in a system log for fields with no getters have now been silenced.


Removed a confusing Hazelcast log message when using High Availability (HA)

By default, Hazelcast logs the "The Jet engine is disabled" message on startup. This message can be interpreted as a warning by administrators, prompting for action.

The CloudBees CI High Availability (HA) functionality does not rely on this component, so we have removed it to clarify any confusion.


BundleUpdateLog continues reading the plugins after removing the bundle

The BundleUpdateLog no longer tries to read the plugins after removing the bundle.


Folder Configuration as Code export is showing SSH private keys in plain text

In the exported YAML, the key privateKeys was showing the SSH private keys in plain text.

This key has been removed from the export.


Failure to install a profile plugin was not always reported

In some conditions, when using a profile to install plugins at startup, if a plugin in the profile cannot be installed as it was not found, the failure may not have been reported correctly in the logs.

Following this change, any failure is reported.


Fixed memory leak in Operations center

When a communication error occured between the controller and the operations center, some resources associated with the HTTP exchange were not released. This resulted in a memory leak and thread retention.

Now, the resources associated with HTTP communication are released systematically, including error cases.

Known Issues

Duplicate Pipeline Template Catalogs in the Configuration as Code for controllers jenkins.yaml file on each instance restart

If a Pipeline Template Catalog is configured in the Configuration as Code jenkins.yaml file and the id property is not defined, the catalog is duplicated on each instance restart and in the exported Configuration as Code configuration.


Saving shared cloud from GUI lost WebSocket checkbox

If a shared cloud (as opposed to a single agent) was defined in 2.426.x (or earlier) with an inbound launcher and a specific launch configuration, particularly the Use WebSocket checkbox (also tunnel and custom work dir settings), configuring and resaving that cloud in the GUI in 2.440.x will silently drop that configuration, potentially breaking a working setup.

As a workaround, avoid resaving such shared clouds using the GUI. Use Configuration as Code with YAML or REST or CLI with XML if some unrelated aspect of the cloud needs to be adjusted.


Reconfiguring static inbound WebSocket agent improperly added blank tunnel

After reconfiguring a static inbound agent in the GUI using fields, such as WebSocket, deprecated in 2.440.x, the suggested launch instructions incorrectly include -tunnel (with no argument) even if that field had been left blank.

As a workaround do the following:

  • manually remove -tunnel from the command line before using

  • reconfigure the agent using Configuration as Code YAML or REST or CLI XML to not include the tunnel field


Inconsistencies between some Configuration as Code (CasC) features and High Availability (HA)

When using Configuration as Code in controllers that run in High Availability (HA) mode, the CloudBees Configuration as Code Export and Update screen may display inconsistent information about the bundle along with two buttons: Restart and Reload. This is caused by information not being properly synchronized between replicas. Furthermore, users may experience the following problems when trying to use one of the two buttons on that page:

  • Automatic reload bundle: clicking this button shows an error message.

  • Skip new bundle version: clicking this button forces a restart and the instance will not start again.

While the fix for this issue is being worked on, we recommend the following if you are using Configuration as Code in controllers that run High Availability (HA):

  • Controllers that have configured the automatic reload. Users must disable it and configure the automatic restart instead.

  • Controllers that do not have any automation (Bundle Update Timing). Users must stop using the Reload button and start using the Restart button instead.


Inbound shared agents aligned with new Remoting CLI options

Certain options for the inbound agent launcher, particularly the checkbox for WebSocket, were removed from the configuration GUI in 2.440.x, in favor of passing the corresponding option such as -webSocket on the CLI. In the case of inbound shared agents or clouds, this did not suffice since the operations center was responsible for launching the cloned agent that connects to the controller. This makes it impossible to create new shared agents or clouds using WebSocket transport via GUI configuration.

As a workaround, configure fields, such as webSocket, in the agent/cloud launcher definition via Configuration as Code YAML or REST or CLI upload of XML; or copy a working agent/cloud item instead of creating one from scratch.

Upgrade Notes

Operations center CloudBees Assurance Program plugin changes since 2.440.2.1

The following plugins have been added to the Operations center CloudBees Assurance Program since 2.440.2.1:

  • CloudBees Platform Insights Plugin (cloudbees-platform-insights)


Controller CloudBees Assurance Program plugin changes since 2.440.2.1

The following plugins have been added to the Controller CloudBees Assurance Program since 2.440.2.1:

  • CloudBees Platform Insights Plugin (cloudbees-platform-insights)