Adds one or more summaries to the current Pipeline build.
Summaries are symbols or icons with an optional text message and an optional clickable hyperlink.
Summaries are often used to provide a visual indicator of additional status information about a Pipeline build.
Summaries added by addSummary
are displayed in the build overview 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:
addSummary icon: 'symbol-alert-circle-outline plugin-ionicons-api', text: 'This is an alert symbol'
addSummary icon: 'symbol-bar-chart-filled plugin-ionicons-api', text: 'This is a bar chart symbol'
addSummary icon: 'symbol-battery-half-sharp plugin-ionicons-api', text: 'This is a half filled battery symbol'
addSummary icon: 'symbol-cube', text: 'This is a Jenkins Core symbol'
addSummary 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:
addSummary icon: '/jenkins.png', text: 'This is a relative image'
addSummary icon: 'https://foo.bar/icon.png', text: 'This is a remote icon'
addSummary 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:
addSummary icon: 'completed.gif', text: 'This is a completed symbol'
addSummary icon: 'success.gif', text: 'This is a success icon'
addSummary icon: 'warning.gif', text: 'This is a warning icon'
The following example adds a "completed" checkmark icon with the text, "This is completed":
addSummary icon: 'completed.gif', text: 'This is completed'
Example: Summary with alarm symbol
The following example adds an alarm symbol with the text, "This is alarming":
addSummary icon: 'symbol-alarm-outline plugin-ionicons-api', text: 'This is alarming'
Example: Summary with red bug symbol
The following example adds a red bug badge symbol the text, "This is a red bug with a link", and a link:
addSummary 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'