This developers guide explains how to construct pipeline configuration files in Pipelines DSL, the YAML-based declarative language used by JFrog Pipelines.

The work that Pipelines performs for CI/CD must be specified by a developer in Pipelines DSL, and stored in a file that has a .yml extension (for example, pipelines.yml). When that file is committed to a Git respository that has been configured in Pipelines as a pipeline source, Pipelines will automatically sync to load and process the Pipelines DSL. 

Developers can create and edit pipeline configuration files in Pipelines DSL using any text editor.

Scope of This Guide

This guide explains the format, syntax, and best practices for creating pipeline configuration files in Pipelines DSL. The guide also covers how to use the DSL to control the provisioning of runtime containers to build nodes where the steps of a pipeline will execute.

Note that this guide does not cover how to operate Pipelines in the user interface of the JFrog Platform Deployment. That information is covered in the following sections of the User Guide:

Configuring Pipelines

How to add, manage, and view Pipelines integrations, pipeline sources, node pools and nodes in the JPD.

These management facilities are available only to those with administrator user permissions. Other users may only view what has been configured by an administrator, limited by user restrictions.

Working with Pipelines

How to view and run pipelines loaded in the JPD, as well as examine their run history and logs.

These facilities are available to all users, and limited to the pipeline sources assigned to each user.

In This Guide