JFrog Help Center

Our new portal is coming soon!
Documentation + Knowledge Base







Overview

To browse pipelines loaded from configured pipelines sources., in the Application tab go to Pipelines | My Pipelines

As described in the sections below, the My Pipelines page is divided into various views. All views adhere to the security rules defined in the system, and only allow you to view pipelines from pipeline sources you have been granted permission to read, and to perform actions authorized by those permissions.

To learn the syntax, and best practices for creating pipeline configuration files in YAML-based Pipelines DSL,  see the  Pipelines Developer Guide.




Pipelines Views

The main My Pipelines page shows three views by default:

All Pipelines and Admin Views

The All Pipelines tab lists the pipelines from all pipeline sources that you have access to, sorted by the latest execution. You may view either all loaded pipelines or only those currently running.

In addition, Project and system-level admins can create custom admin views for pipelines using simple wildcard patterns on pipelines name or branch name. When a view is created for a Project, it is visible to all users of that Project. Up to 10 views can be created per Project.

To create an admin view:

  1. In the Application tab go to Pipelines | My Pipelines, click All Pipelines and then click Add View.
  2. In the Add View window, provide a name and the pattern for the pipeline and branch. Simple wildcard patterns are supported.
  3. Click Create.
    The view is created based on the provided pattern.

My Views 

The My Views tab lists all the custom views that you have created for your pipelines. It shows two views by default:

  • Recent Visits: This tracks visits to pipeline dashboards and shows the pipelines associated with the Project that the user is in. By default, the pipeline that the user visited last is displayed on top.
  • Favorites: This shows all the pipelines that the user has marked as favorite.

In addition, users can create up to five custom views per Project. While the List view will show all the pipelines added for the view, the Graph view will show a maximum of 150 pipelines and their connections, and up to 5  disconnected graphs.

All default views and custom views are in the context of the selected Project.

To create a custom view:

  1. In the Application tab go to Pipelines | My Pipelines, click My Views and then click Add View.
  2. In the Add View window, provide a name and the pattern for the pipeline and branch. Simple wildcard patterns are supported.
  3. Click Create.
    The view is created based on the provided pattern.


Browsing Pipelines

To browse the list of pipelines loaded from all pipeline sources, click the All Pipelines tab.  

View Pipelines

On the Pipelines page, all your pipelines are represented using two views:

List

This view lists all your pipelines in rows.


Each row of the pipeline list includes the following:

Name

The name of the pipeline as identified in the pipeline config.

Click this link to view the Pipeline History.

Branch
The branch of the Git repository the pipeline config was loaded from.
Project
The Project that the pipeline belongs to.
Latest Status
The success or failure of the last run of the pipeline, or if the pipeline config failed validation.
Duration
The duration of the last run of the pipeline.
Last Triggered
The date and time of the last run of the pipeline.
Triggered By
The triggering source of the last run of the pipeline.
Context
The event that triggered the run (if available).
Favorite

Hover over a pipeline and when the Favorite icon appears in this column, click to add the pipeline to your favorites.


Graph

This view, also called the Pipeline of Pipelines view, provides a combined view of all interconnected pipelines and resources. It enables you to navigate from multi-pipeline page to individual pipeline page and back.

In this view, the status of pipelines in the multi-pipeline map is updated in real-time as runs are triggered for various pipelines. Each pipeline is presented as a single entity, which makes it easy to view this map and understand dependencies between pipelines.

The following information is shown for each pipeline:

  • Pipeline name
  • Run number
  • Last run status
  • Last run date/time
  • Time taken for the run to complete

Graph View Actions 

You can perform the following actions on the Graph view page:

  • Show Path: Click any pipeline and then click  Show Path. This highlights all the pipelines and resources that are connected to the selected pipeline, and shows the interconnecting path.


  • View Pipeline: Click any pipeline and then click  View Pipeline  to view the pipeline page for that pipeline.

  • Search: Use the search field to search this page by pipeline name. In the search results, click the name of the relevant pipeline to zoom in on the pipeline, which is now highlighted with a border.


  • Filter: Use the filter field to filter pipelines by status. You can select multiple statuses and all the pipelines matching the selected status is highlighted. In addition, the number of pipelines matching each status is displayed next to the filter field.


    Click one of the statuses and then click the up/down   keys to cycle through the results. 


  • Zoom: Use the zoom buttons, which are located on the right-hand bottom corner of the graph view page, to perform the following actions:

    Button

    Description

    Zoom in. Alternatively, use your mouse to zoom in.

    Zoom out. Alternatively, use your mouse to zoom out.

    Zoom in to only show those pipelines that are not connected to other pipelines.

    Reset view.

View Pipeline-level Graph

You have the option of viewing the graph of individual pipelines, which provides a view of all the pipelines and the resources that connects a specific pipeline to other pipelines.

To view pipeline-level graph:

  1. In the List view, click the name of a pipeline.
  2. Click the menu button and click View Connected Pipelines.


    This displays the graph of that pipeline.

For information about all the actions you can perform on the pipeline-level view, see the section Graph View Actions.

View Connected Runs

Pipelines enables you to view the end-to-end multi-pipeline map for a specific run, which shows the complete path for that run. Interconnected pipelines are shown at the pipeline level, while specific runs are shown at the step level. 

With this view, when you trigger a pipeline, you can get a realtime view of runs being triggered by the preceding run. This is useful for tracking how the previous run created a resource version that triggered the next run, and other properties, such as run number and status.

To view connected runs:

  1. Trigger a pipeline.
  2. Click one of the runs, and in the Run view, click the ellipsis button and then click Connected Runs.

This displays the map of that run, with information about the exact run number that triggered the run.

Favorites 

You can mark any pipeline as a "favorite" by clicking in its row's far right column. Click the My Favorites button to display only those pipelines you have marked as favorites. In this way, you can filter your pipelines list for only those pipelines of interest to you.

The set of marked favorites is associated with your JFrog Platform user account, so that each user can designate their own set of pipelines.

Multibranch Pipelines

Pipelines from a multibranch pipeline source will have several pipelines under the same name. These will be identified under the Branch column as Multibranch, with aggregated success status.

Click  the parent row of a multibranch pipeline  to expand/collapse the display for the run status of each branch. Click the name of one of the branches in the expanded view to go to the detailed branch view.


Active Runs

The Active Runs tab lists all currently running pipelines, with their ongoing status.

Each row of the runs list includes the following:

Pipeline Name

The name of the pipeline as identified in the pipeline config.

Click this link to view the Pipeline History

Status

The status of the currently executing step.

Branch
The branch of the Git repository the pipeline config was loaded from.
Run Number
The number of the currently executing run of the pipeline
Started At

The time that the run commenced.

Triggered By
The initial triggering source of the run.
Context
The event that triggered the run (if available).
  • No labels
Copyright © 2023 JFrog Ltd.