https://github.com/pmsipilot/jenklab-ci

A command-line bridge between Gitlab CI and Jenkins CI
https://github.com/pmsipilot/jenklab-ci

docker gitlab gitlab-ci jenkins jenkins-ci

Last synced: 2 months ago
JSON representation

A command-line bridge between Gitlab CI and Jenkins CI

• Host: GitHub
• URL: https://github.com/pmsipilot/jenklab-ci
• Owner: pmsipilot
• License: mit
• Created: 2017-03-18T17:22:23.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2018-03-15T17:04:14.000Z (almost 7 years ago)
• Last Synced: 2024-09-30T18:01:58.102Z (3 months ago)
• Topics: docker, gitlab, gitlab-ci, jenkins, jenkins-ci
• Language: JavaScript
• Homepage: https://hub.docker.com/r/pmsipilot/jenklab-ci/
• Size: 117 KB
• Stars: 6
• Watchers: 13
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Jenklab CI [![Build Status](https://travis-ci.org/pmsipilot/jenklab-ci.svg?branch=master)](https://travis-ci.org/pmsipilot/jenklab-ci)

![Jenklab CI ](resources/jenklab-ci-horiz.png)

A command-line bridge between Gitlab CI and Jenkins CI.

## Why?

Sometimes your CI is spread between Gitlab CI and Jenkins. Using a single UI to follow all your jobs is better than 

switching between two of them.

Gitlab has a nice UI for pipelines, it better than Jenkins' one.

This utility will let you trigger Jenkins jobs right from Gitlab pipelines. It will also forward the whole Gitlab CI

environment to Jenkins as build parameters.

You will be able to see the whole build log direclty from Gitlab CI.

## Usage

Jenklab CI is accessible through a command-line script:

```sh

pmsipilot-jenklab-ci 1.4.0 - A command-line bridge between Gitlab CI and Jenkins CI

  

USAGE

  jenklab-ci build 

ARGUMENTS

        Job name      required

OPTIONS

  --https                         Use https to reach Jenkins               optional      default: false

  --host                    Jenkins host name                        optional

  --port                    Jenkins port number                      optional

  --username            Jenkins username                         optional

  --token                  Jenkins token                            optional

  --polling-interval       Polling interval (seconds)               optional      default: 5    

  --parameter         Additional parameters                    optional

  --dot                           Use a dot report, do not stream log      optional      default: false

GLOBAL OPTIONS

  -h, --help         Display help

  -V, --version      Display version

  --no-color         Disable colors

  --quiet            Quiet mode - only displays warn and error messages

  -v, --verbose      Verbose mode - will also output debug messages

```

A Docker image is also available to let you add it to your `.gitlab-ci.yml`:

```sh

stages:

    # ...

    - jenkins

    

jenkins-job-name:

    image: pmsipilot/jenklab-ci

    tags:

        - swarm

    stage: jenkins

    when: manual

    script:

        - jenklab-ci build $CI_JOB_NAME

    after_script:

        - jenklab-ci kill

```

## Caveats

* Jenklab CI will stream the Jenkins build log to the Gitlab CI console: this can lead to huge logs stored in your 

Gitlab database.

* Your Jenkins job might take longer due to the time spent in queue. By default, Gitlab CI jobs are killed after 60 

minutes. You might need to change the job timeout in you Gitlab project's CI/CD configuration.

## License

This project is released under the [MIT license](LICENSE) except for the [logos](resources) which are released under 

the [Creative Commons Attribution-ShareAlike 3.0 Unported License](https://creativecommons.org/licenses/by-sa/3.0/) as

requested by the [Jenkins project's](https://jenkins.io/) license [terms](https://wiki.jenkins.io/display/JENKINS/Logo).