plugins.yaml file reference

plugins.yaml

This file lists all the plugins to be installed on the controller or the operations center.

The content in the file changes depending on the value of the apiVersion field.

For CasC bundles using apiVersion:1, this file should be a list of plugin IDs for CAP and non-CAP plugins to be installed.

For CasC bundles that use apiVersion:2, this file has a more complex structure and can include the following:

A list of plugin IDs for CAP plugins.
Non-CAP plugins, in three different ways:
- Using only the plugin ID if the Non-CAP plugin is downloaded from the CloudBees Update Center or using a plugin catalog.
- Using the plugin ID and a URL if the Non-CAP plugin is directly downloaded from a URL.
- Using the plugin ID, the groupId, the version, and the repositoyId if the Non-CAP plugin is downloaded from a Maven repository.

CloudBees CI ignores URLs and GAV coordinates for those plugins that are also part of the plugin-catalog.yaml file. In those cases, the configuration in plugins.yaml is ignored, and the configuration in plugin-catalog.yaml prevails.

Find many popular plugins and their IDs at the following sites:

For more information, refer to casc-plugin-management:index.adoc[].