Jenkins Views¶
View Templates¶
JJB view-templates provides a way to manage Jenkins views through code. Using view-templates we can define common views configuration that are interesting to a project.
We recommend creating separate project sections for views apart from job configuration such that job configuration does not overlap with the view configuration.
Example Usage:
---
- project:
name: project-view
views:
- common-view
project-name: project
- project:
name: project-stream1
jobs:
- '{project-name}-{seq}'
project: project
project-name: project
seq:
- a
- b
- project:
name: project-stream2
jobs:
- '{project-name}-{seq}'
project: project
project-name: project
seq:
- x
- y
- job-template:
name: '{project-name}-{seq}'
Project view¶
Groups all jobs owned by a project under one view by capturing jobs with the
prefix of project-name
.
This view uses the following columns:
- Columns:
status
weather
job
last-success
last-failure
last-duration
build-button
jacoco
find-bugs
- Template Names:
{project-name}
project-view
- Required parameters:
- project-name:
The name of the project utilizing the view.
- Optional parameters:
- view-filter-executors:
View filter executor. (default: false)
- view-filter-queue:
View filter queue. (default: false)
- view-recurse:
View recurse. (default: false)
Example:
---
- project:
name: project-view-test
views:
- project-view
project-name: project-view-test
Common view¶
Groups all jobs owned by a project under one view by capturing jobs with the
prefix of project-name
.
This view uses the following columns:
- Columns:
status
weather
job
last-success
last-failure
last-duration
build-button
jacoco
find-bugs
- Template Names:
{view-name}
common-view
- Required parameters:
- view-name:
The name of the view.
- view-regex:
Regex to match the jobs.
- Optional parameters:
- view-filter-executors:
View filter executor. (default: false)
- view-filter-queue:
View filter queue. (default: false)
- view-recurse:
View recurse. (default: false)
Example:
---
- project:
name: common-view-test
views:
- common-view
view-name: Daily
view-regex: ".*-daily-.*"
CSIT view template¶
View template that loads columns useful for CSIT jobs.
This view uses the following columns:
- Columns:
status
weather
job
last-success
last-failure
last-duration
build-button
robot-list
- Template Names:
{view-name}
csit-view
- Required parameters:
- view-name:
The name of the view.
- view-regex:
Regex to match the jobs.
- Optional parameters:
- view-description:
View description. (default: ‘CSIT Jobs.’)
- view-filter-executors:
View filter executor. (default: false)
- view-filter-queue:
View filter queue. (default: false)
- view-recurse:
View recurse. (default: false)
Example:
---
- project:
name: csit-view-test
views:
- csit-view
view-name: CSIT-1node
view-regex: ".*csit-1node.*"