Creating Jenkins topology templates

Over time topologies generated via a specific Jenkins Observer job may grow, including the information from different Jenkins builds. You can use the Agile Service Manager topology template functionality to create meaningful, scoped views per build.

About this task

This topic describes two suggested build templates:
  • Topology per build
  • Current pipeline status
The use of the Agile Service Manager templates is described in the Using resource group templates topic.

Procedure

Create 'per build' topology templates
The following template lets you visualize individual topologies for each build.

  1. As the admin user, log into your DASH web application, select Administration from the DASH menu, then select Topology Templates under the Agile Service Management heading.
  2. Search for build by its entity type, or by a specific build name (for example, sample-pipeline/master), and then select View Topology next to a result.
  3. Select the Dynamic template type to ensure that all matching builds will generate topologies like this.
  4. On the Preview pane, right-click the build resource and select Follow Relationship, then repeat this for all the connected resources in your build topology.
    Important: Do not expand the 'lastRunOf' relationship.
  5. Optionally, define tags for the template, then click Save template and generate topologies.

Create a 'current pipeline status' topology template

The following template generates topologies that show the current status of your pipeline, that is, the latest build for which a notification was received.

  1. As the admin user, log into your DASH web application, select Administration from the DASH menu, then select Topology Templates under the Agile Service Management heading.
  2. Search for job by its entity type, or by a specific build name (for example, sample-pipeline), and then select View Topology next to a result.
  3. Select the Dynamic template type to ensure that all matching builds will generate topologies like this.
  4. On the Preview pane, right-click the job resource, select Follow Relationship, then click lastRunOf.
    The latest build resource for which a topology was generated is displayed.
  5. Expand any relationships you want to include in this template.
    Important: Do not expand the 'RunOf' relationship.
  6. Optionally, define tags for the template, then click Save template and generate topologies.