automatic builds for maven, jenkins and gitbucket

Automate maven builds using Jenkins and gitbucket

This setup demo a full automation setup using nginx, gitbucket, Jenkins, Pipeline multibranch, Github branch source, webhooks and build statuses.

In this setup the goal is to:

fire a build for each commit, on every branch or on any PR
have different project versions per branch and PR
to have build statuses set on git commits

Environnement

All the setup below is provided as an example, adapt with recent versions and with your platform.
I built this setup on windows 10.

The services will be availabe at:

jenkins: http://jenkins.my.pc
gitbucket: http://gitbucket.my.pc

hosts

We will fake DNS names for gitbucket & jenkins services. Edit your hosts file, mine is under C:\Windows\System32\drivers\etc, add entries for the 2 services

127.0.0.1 jenkins.my.pc
127.0.0.1 gitbucket.my.pc

nginx

We will serve both services on port 80 using the server names defined above. For that we will a nginx reverse proxy.

Having a nginx-1.12.1 running instance, mine is installed under D:\dev\tools\web\nginx\nginx-1.12.1

Create NGINX_HOME\conf\ci.conf file.

server {
    listen 80;
    server_name jenkins.my.pc;
     
    location / {
 
      proxy_set_header        Host $host:$server_port;
      proxy_set_header        X-Real-IP $remote_addr;
      proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header        X-Forwarded-Proto $scheme;
 
      # Fix the "It appears that your reverse proxy set up is broken" error.
      proxy_pass          http://127.0.0.1:8090;
      proxy_connect_timeout   150;
      proxy_send_timeout      100;
      proxy_read_timeout      100;
  
      # Required for new HTTP-based CLI
      proxy_http_version 1.1;
      proxy_request_buffering off;
    }
}
  
server {
    listen 80;
    server_name gitbucket.my.pc;

    location / {
        proxy_pass              http://127.0.0.1:8080;
        proxy_set_header        Host $host;
        proxy_set_header        X-Real-IP $remote_addr;
        proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_connect_timeout   150;
        proxy_send_timeout      100;
        proxy_read_timeout      100;
        proxy_buffers           4 32k;
        client_max_body_size    500m; # Big number is we can post big commits.
        client_body_buffer_size 128k;
    }
}

edit NGINX_HOME\conf\nginx.conf, add an include to above file.

...
http {
   ...
   # Include CI specific setup for gitbucket & jenkins
   # put the include INSIDE the http tag
   include "D:/dev/tools/web/nginx/nginx-1.12.1/conf/ci.conf";
}
...

Restart/reload nginx: nginx -s reload

gitbucket

Here we will use a default installation of gitbucket using version 4.21.2.

Download gitbucket.war from 4.21.2 release.

start gitbucket: java -jar gitbucket.war
navigate to http://gitbucket.my.pc/
connect using root/root, then create users:
- ci/ci: an administrator, will be used from jenkins
- john/j: a simple user
- bill/b: another simple user

jenkins

Download Jenkins and run it using java -jar jenkins.war --httpPort=8090

I personally skipped default installation and then manually added:

GitHub Branch Source Plugin 2.3.1
Pipeline: Basic Steps 2.6
Pipeline: Model API 1.2.5
Pipeline: Multibranch with defaults 1.1
Pipeline: Nodes and Processes 2.17
Pipeline: Shared Groovy Libraries 2.9
Pipeline: Stage Step 2.3

Configure jenkins:

Manage Jenkins > Configuration

Jenkins url: http://jenkins.my.pc/
Add a Github Enterprise Server:
- API endpoint: http://gitbucket.my.pc/api/v3
- Name: Gitbucket local

Manage Jenkins > Global Tool Configuration

Add a git installation, point it to git.exe on your disk. A recent version of git.exe is required, because git.exe will have to follow http redirections ; my version is 2.14.2.windows.2
Add a JDK 1.8 installation, name it JDK 1.8
Add a Maven 3.3.x installation, name it Maven 3.3.x

Setup

We will use the project demo-ci-jgitver-maven-plugin.

Gitbucket project creation and setup

Create placeholder project in John gitbucket space.

Connect as john/j
Create placeholder repository, call it demo-ci
checkout github project and push it to john space

git clone https://github.com/jgitver/demo-ci-jgitver-maven-plugin.git demo-ci
cd demo-ci
git push http://john:[email protected]/git/john/demo-ci.git

Go to gitbucket project settings page, choose "Service Hooks" tab
Add a webhook to http://jenkins.my.pc/github-webhook/, select "Pull Request" & "Push" events