mirror of
https://github.com/SAP/jenkins-library.git
synced 2024-12-14 11:03:09 +02:00
47 lines
1.5 KiB
Markdown
47 lines
1.5 KiB
Markdown
# pipelineExecute
|
|
|
|
## Description
|
|
|
|
Loads a pipeline from a git repository. The idea is to set up a pipeline job in Jenkins that loads a minimal pipeline, which in turn loads the shared library and then uses this step to load the actual pipeline.
|
|
|
|
A centrally maintained pipeline script (Jenkinsfile) can be re-used by
|
|
several projects using `pipelineExecute` as outlined in the example
|
|
below.
|
|
|
|
## Prerequisites
|
|
|
|
none
|
|
|
|
## Parameters
|
|
|
|
| parameter | mandatory | default | possible values |
|
|
| -------------------|-----------|-----------------|-----------------|
|
|
| `repoUrl` | yes | | |
|
|
| `branch` | no | 'master' | |
|
|
| `path` | no | 'Jenkinsfile' | |
|
|
| `credentialsId` | no | An empty String | |
|
|
|
|
* `repoUrl` The url to the git repository of the pipeline to be loaded.
|
|
* `branch` The branch of the git repository from which the pipeline should be checked out.
|
|
* `path` The path to the Jenkinsfile, inside the repository, to be loaded.
|
|
* `credentialsId` The Jenkins credentials containing user and password needed to access a private git repository.
|
|
|
|
## Step configuration
|
|
|
|
none
|
|
|
|
## Side effects
|
|
|
|
none
|
|
|
|
## Exceptions
|
|
|
|
* `Exception`
|
|
* If `repoUrl` is not provided.
|
|
|
|
## Example
|
|
|
|
```groovy
|
|
pipelineExecute repoUrl: "https://github.com/MyOrg/MyPipelineRepo.git", branch: 'feature1', path: 'path/to/Jenkinsfile', credentialsId: 'MY_REPO_CREDENTIALS'
|
|
```
|