Pipelines Step-By-Step

Overview

After you have aPipelines installationworking within the JFrog Platform, you can get started by connecting Pipelines to build nodes, source repositories and other services. After those essentials are in place, you can start coding (using YAML) and running your pipelines.

This section introduces you to the essential concepts and provides information about the primary building blocks for creating and running a pipeline.

This page is intended to provide a brief overview of all the steps required for executing a pipeline. For detailed information about each step, use the links provided in theDive Deepersections.
If you want to be more hands-on, try ourQuickstarts.

Administrators and Developers

Pipelines can have two types of users, based on the permissions assigned to them:

Administrator: Pipelines does not grant access to all facilities to all users, restricting most configuration facilities toadministrator usersonly.An administrator can add node pools, integrations, and pipeline sources.
Developer(non-administrator users): A developer can create YAML files, view and use the node pools, integrations and pipeline sources assigned to them, and run their pipelines. To connect Git repositories and other services to Pipelines, a developer will need assistance from an administrator.

Page Contents

Creating and Running a Pipeline

Before you start, anadministrator usermust perform the required procedures that connect Pipelines to the machines and services that enable a pipeline to run.
The section below is meant to provide you an overview of the steps involved in creating and running a pipeline. However, successful run of a pipeline requires a few prerequisites. For more information, seePipelines Quickstart.

The main steps for creating and running a pipeline are as follows:

Step 1: Create a Node Pool

Who can perform this step?	Administrators only. Other users can go toApplication \|Pipelines \| Node Poolsto view the node pools that an administrator has assigned to them.
Description	To run a pipeline, you must provide Pipelines with machines for steps to execute on. In Pipelines, these machines are callednodes, and they are organized intonode pools. Pipelines must be configured with at least one node pool that contains at least one node. One node pool is set as the default node pool and available to all users. You have a variety of choices in how node pools can be configured. Your nodes can bestatic(a VM in at a fixed IP address) ordynamic(on-demand in a cloud service).
Step(s)	添加一个节点池和节点,从Administrationtab, go toPipelines \| Node Pools, and clickAdd Node Pool.
Dive Deeper	For information about adding a static or dynamic node pool, see妈naging Pipelines Node Pools.

Step 2: Add Integrations

Who can perform this step?	Administrators only. Other users can go toApplication \|Pipelines \| Integrationsto view the integrations that an administrator has assigned to them.
Description	For Pipelines to connect to other services, such as GitHub, Artifactory, or Kubernetes,integrationsmust be added for those services. The integration must be provided with the URL endpoint for those services and credentials for a user account on that service, along with any other relevant parameters.
Step(s)	To add the integration, from theAdministrationtab, go toPipelines \|Integrations, and clickAdd an Integration. Here, we add aGitHub Integration——但是你可以添加一个VCS系统集成m you prefer to use, whether that'sGitHub Enterprise,GitLab,Bitbucket, orBitbucket Server. For the full list of all the integrations you can add, seePipelines Integrations. After your integration is successfully added, it is listed among the available integrations.
Dive Deeper	For more information, see妈naging Pipelines Integrations.

Step 3: Create the Pipeline DSL

Who can perform this step?	Administrators and Developers.
Description	Pipelines are defined using Pipelines DSL, stored in one or more YAML files of key-value pairs, known as apipeline config. A Pipelines DSL looks like this:
Step(s)	Create a directory named .jfrog-pipelines in your source VCS repository, such as Git, and then commit the .yml file to this directory.
Dive Deeper	For more information, seeDefining a Pipeline.

Step 4: Add a Pipeline Source

Who can perform this step?	Administrators only. Other users can go toApplication \|Pipelines \|Pipelines Sourcesto view the pipeline sources that an administrator has assigned to them.
Description	For Pipelines to read and sync the Pipelines DSL from the source VCS repository, you must tell it where to find it by adding apipeline source. This is best performed only after the Pipelines DSL file is checked into the source repo, so that Pipelines can sync the file immediately.
Step(s)	To add a pipeline source, from theAdministrationtab, go toPipelines \|Pipelines Sources, and clickAdd Pipeline Source. Once the pipeline source is successfully added, Pipelines will sync the file to load the DSL file and create the declared resources and pipelines.
Dive Deeper	For more information, see妈naging Pipeline Sources.

Step 5: Run the Pipeline

Who can perform this step?	Administrators and Developers.
Description	Trigger either a manual and automatic run of the pipeline.
Step(s)	The following are the steps for running a pipelineusing the new UI. If you want the perform the same steps using the old UI, see the expandable section below. To browse pipelines loaded from configured pipelines sources, in theApplicationtab, go toPipelines \| My Pipelines. After your Git repo has been added as a pipeline source, you can see your pipeline inMy Pipelines. Click the name of the pipeline to seea real time, interactive, diagram of the pipeline and the results of its most current run. A pipeline can be defined to trigger execution when a new commit is made to the Git repo. You can also execute the pipeline by manually click theRunbutton or triggering the first step. Once the pipeline has completed, a new run will be listed. Click the row of the run to view the run log for what just executed. Steps using old UI The following are the steps for running a pipelineusing the old UI. If you want the perform the same steps using the new UI, see the section above. To browse pipelines loaded from configured pipelines sources, in theApplicationtab, go toPipelines \| My Pipelines. After your Git repo has been added as a pipeline source, you can see your pipeline inMy Pipelines. Click the name of the pipeline to seea real time, interactive, diagram of the pipeline and the results of its most current run. A pipeline can be defined to trigger execution when a new commit is made to the Git repo. You can also execute the pipeline by manually triggering the first step. Once the pipeline has completed, a new run will be listed. Click the row of the run to view the run log for what just executed.
Dive Deeper	For more information on triggering pipelines, seeRunning a Pipeline. For information on examining a pipeline's execution, seePipeline Run Logs.

Content

Space Tools