Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/appleboy/drone-jenkins

Drone plugin for trigger Jenkins jobs.
https://github.com/appleboy/drone-jenkins

docker drone drone-plugin jenkins

Last synced: about 1 month ago
JSON representation

Drone plugin for trigger Jenkins jobs.

Lists

README 

        
# drone-jenkins



![logo](./images/logo.png)



[![GoDoc](https://godoc.org/github.com/appleboy/drone-jenkins?status.svg)](https://godoc.org/github.com/appleboy/drone-jenkins)

[![Build Status](https://cloud.drone.io/api/badges/appleboy/drone-jenkins/status.svg)](https://cloud.drone.io/appleboy/drone-jenkins)

[![codecov](https://codecov.io/gh/appleboy/drone-jenkins/branch/master/graph/badge.svg)](https://codecov.io/gh/appleboy/drone-jenkins)

[![Go Report Card](https://goreportcard.com/badge/github.com/appleboy/drone-jenkins)](https://goreportcard.com/report/github.com/appleboy/drone-jenkins)

[![Docker Pulls](https://img.shields.io/docker/pulls/appleboy/drone-jenkins.svg)](https://hub.docker.com/r/appleboy/drone-jenkins/)

[![microbadger](https://images.microbadger.com/badges/image/appleboy/drone-jenkins.svg)](https://microbadger.com/images/appleboy/drone-jenkins "Get your own image badge on microbadger.com")



[Drone](https://github.com/drone/drone) plugin for trigger [Jenkins](https://jenkins.io/) jobs.



## Setup the Jenkins Server



Setup the Jenkins server using the docker command:



```sh

$ docker run \

  --name jenkins \

  -d --restart always \

  -p 8080:8080 -p 50000:50000 \

  -v /data/jenkins:/var/jenkins_home \

  jenkins/jenkins:lts

```



Please make sure that you create the `/data/jenkins` before starting the Jenkins. Create the new API token as below:



![jenkins token](./images/jenkins-token.png)



## Build or Download a binary



The pre-compiled binaries can be downloaded from [release page](https://github.com/appleboy/drone-jenkins/releases). Support the following OS type.



* Windows amd64/386

* Linux amd64/386

* Darwin amd64/386



With `Go` installed



```sh

go get -u -v github.com/appleboy/drone-jenkins

```



or build the binary with the following command:



```sh

make build

```



## Docker



Build the docker image with the following commands:



```sh

make docker

```



## Usage



There are three ways to trigger jenkins jobs.



### Usage from binary



trigger single job.



```bash

drone-jenkins \

  --host http://jenkins.example.com/ \

  --user appleboy \

  --token XXXXXXXX \

  --job drone-jenkins-plugin

```



trigger multiple jobs.



```bash

drone-jenkins \

  --host http://jenkins.example.com/ \

  --user appleboy \

  --token XXXXXXXX \

  --job drone-jenkins-plugin-1 \

  --job drone-jenkins-plugin-2

```



### Usage from docker



trigger single job.



```bash

docker run --rm \

  -e JENKINS_BASE_URL=http://jenkins.example.com/

  -e JENKINS_USER=appleboy

  -e JENKINS_TOKEN=xxxxxxx

  -e JENKINS_JOB=drone-jenkins-plugin

  appleboy/drone-jenkins

```



trigger multiple jobs.



```bash

docker run --rm \

  -e JENKINS_BASE_URL=http://jenkins.example.com/

  -e JENKINS_USER=appleboy

  -e JENKINS_TOKEN=xxxxxxx

  -e JENKINS_JOB=drone-jenkins-plugin-1,drone-jenkins-plugin-2

  appleboy/drone-jenkins

```



### Usage from drone ci



Execute from the working directory:



```sh

docker run --rm \

  -e PLUGIN_URL=http://example.com \

  -e PLUGIN_USER=xxxxxxx \

  -e PLUGIN_TOKEN=xxxxxxx \

  -e PLUGIN_JOB=xxxxxxx \

  -v $(pwd):$(pwd) \

  -w $(pwd) \

  appleboy/drone-jenkins

```



You can get more [information](DOCS.md) about how to use scp plugin in drone.



## Testing



Test the package with the following command:



```sh

make test

```