mirror of
https://github.com/appleboy/drone-jenkins.git
synced 2026-06-14 22:11:30 +08:00
Bo-Yi Wu
155 lines
3.9 KiB
Markdown
155 lines
3.9 KiB
Markdown
<img src="images/logo.png">
|
|
|
|
# drone-jenkins
|
|
|
|
[](https://godoc.org/github.com/appleboy/drone-jenkins)
|
|
[](https://cloud.drone.io/appleboy/drone-jenkins)
|
|
[](https://codecov.io/gh/appleboy/drone-jenkins)
|
|
[](https://goreportcard.com/report/github.com/appleboy/drone-jenkins)
|
|
[](https://hub.docker.com/r/appleboy/drone-jenkins/)
|
|
[](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:
|
|
|
|
<img src="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
|
|
|
|
```
|
|
$ go get -u -v github.com/appleboy/drone-jenkins
|
|
```
|
|
|
|
or build the binary with the following command:
|
|
|
|
```
|
|
$ make build
|
|
```
|
|
|
|
## Docker
|
|
|
|
Build the docker image with the following commands:
|
|
|
|
```
|
|
$ make docker
|
|
```
|
|
|
|
Please note incorrectly building the image for the correct x64 linux and with
|
|
GCO disabled will result in an error when running the Docker image:
|
|
|
|
```
|
|
docker: Error response from daemon: Container command
|
|
'/bin/drone-jenkins' not found or does not exist..
|
|
```
|
|
|
|
## Usage
|
|
|
|
There are three ways to trigger jenkins jobs.
|
|
|
|
- [drone-jenkins](#drone-jenkins)
|
|
- [Setup the Jenkins Server](#setup-the-jenkins-server)
|
|
- [Build or Download a binary](#build-or-download-a-binary)
|
|
- [Docker](#docker)
|
|
- [Usage](#usage)
|
|
- [Usage from binary](#usage-from-binary)
|
|
- [Usage from docker](#usage-from-docker)
|
|
- [Usage from drone ci](#usage-from-drone-ci)
|
|
- [Testing](#testing)
|
|
|
|
<a name="usage-from-binary"></a>
|
|
### 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
|
|
```
|
|
|
|
<a name="usage-from-docker"></a>
|
|
### 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
|
|
```
|
|
|
|
<a name="usage-from-drone-ci"></a>
|
|
### Usage from drone ci
|
|
|
|
Execute from the working directory:
|
|
|
|
```
|
|
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:
|
|
|
|
```
|
|
$ make test
|
|
```
|