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: 19 days ago
JSON representation

Drone plugin for trigger Jenkins jobs.

• Host: GitHub
• URL: https://github.com/appleboy/drone-jenkins
• Owner: appleboy
• License: mit
• Created: 2016-10-15T00:53:03.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2024-11-25T08:52:30.000Z (5 months ago)
• Last Synced: 2025-04-10T08:31:42.612Z (23 days ago)
• Topics: docker, drone, drone-plugin, jenkins
• Language: Go
• Homepage:
• Size: 380 KB
• Stars: 39
• Watchers: 5
• Forks: 17
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-go - drone-jenkins - Drone plugin for trigger Jenkins jobs. - ★ 16 (Software Packages)
• awesome-go-extra - drone-jenkins - 10-15T00:53:03Z|2022-05-09T16:05:49Z| (Go Tools / DevOps Tools)

README

        
# drone-jenkins

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

[![Lint and Testing](https://github.com/appleboy/drone-jenkins/actions/workflows/lint.yml/badge.svg)](https://github.com/appleboy/drone-jenkins/actions/workflows/lint.yml)

[![GoDoc](https://godoc.org/github.com/appleboy/drone-jenkins?status.svg)](https://godoc.org/github.com/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)

[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 install 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

  ghcr.io/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

  ghcr.io/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) \

  ghcr.io/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

```