CloudBees CasC Server Plugin 1.2

3 minute read

RELEASED: Public: 2021-06-02

New features

CasC bundles can be configured as an inheritance chain (BEE-1974)

You can now simplify CasC bundle composition and maintenance by creating a "child" bundle that inherits common configuration elements from a "parent" bundle. This allows you to maintain common configuration elements in a single parent bundle that are automatically inherited by all bundles in the inheritance chain, eliminating the need to manually maintain and update individual bundles. CasC bundle inheritance is a Preview feature.

A default CasC bundle can be pre-selected for new controllers (BEE-1983)

In operations center, a Default bundle option is now available in the Configuration as Code bundles screen to allow you to pre-select a CasC bundle in the controller configuration screen when setting up a new controller. For more information, see Configuration as Code for controllers.

The Configuration as Code bundles screen now provides additional bundle information (BEE-1251)

In operations center, the Configuration as Code bundles screen now includes Used by and Available for columns that allow you to easily determine:

  • controllers currently assigned to a bundle.

  • controllers that can be assigned to a bundle based on the current Availability pattern.

Ensure backwards compatibility for old versions of controllers (BEE-3413)

The effective bundle is now returned by legacy methods to keep backwards compatibility.

Use the .zip bundle download instead of a file-by-file implementation.

Feature enhancements

The CasC Link file information is now available in the controller’s Manage screen in operations center (BEE-2011)

In operations center, the link file details and download link are now available in the controller’s Manage screen. Previously, the link file and download link were available from the Configuration as Code bundles screen. For more information, see Configuration as Code for controllers.

The following options have also been removed from the Configuration as Code bundles screen:

  • Viewing the bundle’s URL and security token.

  • Regenerate the security token button.

  • Copy link file content button.

If you need to regenerate the bundle’s token, you can use the casc-bundle-regenerate-token CLI command. For more information, see Configuration as Code (CasC) CLI.
Multiple files per section within a CasC bundle (BEE-391)

CasC bundles now support storing configuration settings within subfolders for: jcasc, items, rbac, and plugins. The plugin catalog does not support more than one file.

  • Jenkins Configuration as Code (JCasC) files are processed by folder, as described in the Jenkins Configuration as Code plugin documentation.

  • All plugins included within individual plugin files are installed.

  • Existing global groups and roles are replaced by groups and roles in the files.

  • Files are processed by adding groups and roles, but never removing groups or roles.

  • Items files are processed one-by-one using the same criteria as before.

The Configuration as Code (CasC) bundle version is automatically generated (BEE-1254)

The CasC bundle version number is automatically generated based on the content of the files to avoid potential problems during a configuration bundle update.

Resolved issues

Additions and removal of bundles when the operations center is down are not detected (BEE-3430)

If an existing bundle is removed from operations center when the instance is not up and running, its access control configuration remains in the configuration files and the bundle is still in memory.

If a new bundle is added in operations center when the instance is not up and running, its access control can be configured through the configuration page, but an error is thrown when the Save button for that bundle is selected.

Now, when the operations center is starting, it checks for bundle additions and removals, and saves the new configuration so an error is no longer returned on the configuration page.

Known issues

None.

Upgrade notes

None.