Adds one or more badges to the current Pipeline build.
Badges are symbols or icons with an optional text message and an optional clickable hyperlink.
Badges are often used to provide a visual indicator of additional status information about a Pipeline build.
Badges added by addBadge
are displayed in the build history of the Pipeline job.
The plugin supports symbols from the ionicons library through the ionicons-api-plugin. More symbols can be added by installing additional plugins, such as font-awesome-api-plugin or custom-folder-icon-plugin. Symbols from plugins are referenced as "symbol-icon-name plugin-plugin-name" and Jenkins Core icons as "icon-icon-name" or "symbol-icon-name". For example, the following are all valid references to symbols:
addBadge icon: 'symbol-alert-circle-outline plugin-ionicons-api', text: 'This is an alert symbol'
addBadge icon: 'symbol-bar-chart-filled plugin-ionicons-api', text: 'This is a bar chart symbol'
addBadge icon: 'symbol-battery-half-sharp plugin-ionicons-api', text: 'This is a half filled battery symbol'
addBadge icon: 'symbol-cube', text: 'This is a Jenkins Core symbol'
addBadge icon: 'icon-gear', text: 'This is a Jenkins Core icon'
The plugin allows you to also reference images from within Jenkins as well as relative and remote URL:
addBadge icon: '/jenkins.png', text: 'This is a relative image'
addBadge icon: 'https://foo.bar/icon.png', text: 'This is a remote icon'
addBadge icon: 'blue.png', text: 'This is a icon from Jenkins'
The plugin includes icons as GIF images and also supports the 16x16 icons that are offered by Jenkins. These icons are listed in the plugin documentation and are referenced as "image-name.gif". For example, the following are all valid references to icons included with the plugin:
addBadge icon: 'completed.gif', text: 'This is a completed symbol'
addBadge icon: 'success.gif', text: 'This is a success icon'
addBadge icon: 'warning.gif', text: 'This is a warning icon'
The following example adds a "completed" checkmark icon with the text, "This is completed":
addBadge icon: 'completed.gif', text: 'This is completed'
Example: Badge with alarm symbol
The following example adds an alarm symbol with the text, "This is alarming":
addBadge icon: 'symbol-alarm-outline plugin-ionicons-api', text: 'This is alarming'
Example: Badge with red bug symbol
The following example adds a red bug symbol with the text, "This is a red bug with a link", and a link:
addBadge icon: 'symbol-bug plugin-ionicons-api', text: 'This is a red bug with a link', style: 'color: red', link: 'https://issues.jenkins.io/browse/JENKINS-59646'
Example: Text badge with CSS styles
The following example adds text only badge that uses included CSS styles:
// Add shaded background color with rounded corners
addBadge text: 'ok', style: 'color: var(--success-color)', cssClass: 'badge-text--background'
// Add additional border around badge
addBadge text: '1.0.0', cssClass: 'badge-text--background badge-text--bordered'