Files
plugin-drone-jenkins/DOCS.md
T
2017-01-20 15:06:16 +08:00

78 lines
1.4 KiB
Markdown

---
date: 2017-01-16T00:00:00+00:00
title: Jenkins
author: appleboy
tags: [ infrastructure, trigger, jenkins ]
repo: appleboy/drone-jenkins
logo: jenkins.svg
image: appleboy/drone-jenkins
---
The Jenkins plugin allows you to trigger Jenkins job automatically. The below pipeline configuration demonstrates simple usage:
```yaml
pipeline:
jenkins:
image: appleboy/drone-jenkins
url: http://example.com
user: appleboy
token: xxxxxxxxxx
job: drone-jenkins-plugin-job
```
Example configuration for success builds:
```diff
pipeline:
jenkins:
image: appleboy/drone-jenkins
url: http://example.com
user: appleboy
token: xxxxxxxxxx
job: drone-jenkins-plugin-job
+ when:
+ status: [ success ]
```
Example configuration with multiple jobs:
```yaml
pipeline:
jenkins:
image: appleboy/drone-jenkins
url: http://example.com
user: appleboy
token: xxxxxxxxxx
job:
+ - drone-jenkins-plugin-job-1
+ - drone-jenkins-plugin-job-2
```
Example configuration with jobs in the folder:
```yaml
pipeline:
jenkins:
image: appleboy/drone-jenkins
url: http://example.com
user: appleboy
token: xxxxxxxxxx
+ job: folder_name/job_name
```
It will trigger the URL of Jenkins job like as `http://example.com/job/folder_name/job/job_name/`
# Parameter Reference
url
: jenkins server base url.
user
: jenkins user account
token
: jenkins user token
job
: jenkins job name