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.*"