Update jenkins - Added config files section authored by MPHSlaats's avatar MPHSlaats
......@@ -9,8 +9,9 @@ You can find Jenkins at [jenkins.mphslaats.com](https://jenkins.mphslaats.com).
- [Installation](#installation)
- [Configuration](#configuration)
- [Email bot](#email-bot)
- [Maven projects](#maven-projects)
- [Run job after commit in Gitlab](#run-job-after-commit-in-gitlab)
- [Maven projects](#maven-projects)
- [Config files](#config-files)
- [Installed plugins](#installed-plugins)
## Resources
......@@ -42,15 +43,7 @@ By default Jenkins runs on port 8080, however Jenkins is a website therefore you
* Password: ****;
* Use SSL: True;
* SMTP Port: 465;
* If Jenkins tells you that your reverse proxy setup is broken, than you have to add `proxy_set_header X-Forwarded-Proto $scheme;` to the proxy server;
### Maven projects
* Now let's add both Git and Maven to Jenkins:
* First start by manually installing them by using `apt-get install git maven openjdk-8-jdk`;
* Now use `which git` to find out where git is installed (`/usr/bin/git`);
* Use `whereis maven` to find where maven's home directory is (`/usr/share/maven`);
* Go to [jenkins.mphslaats.com/configureTools](https://jenkins.mphslaats.com/configureTools) and add the git, maven and jdk (`/usr/lib/jvm/default-java`) directories;
* To make full use of Maven go to [jenkins.mphslaats.com/pluginManager/available](https://jenkins.mphslaats.com/pluginManager/available) and add Maven Intergration;
* If Jenkins tells you that your reverse proxy setup is broken, than you have to add `proxy_set_header X-Forwarded-Proto $scheme;` to the proxy server.
### Run job after commit in Gitlab
* Go to [jenkins.mphslaats.com/pluginManager/available](https://jenkins.mphslaats.com/pluginManager/available) and add the GitLab Plugin;
......@@ -64,6 +57,19 @@ By default Jenkins runs on port 8080, however Jenkins is a website therefore you
* Use the generated token from Jenkins as Secret token and add the Webhook;
* If you now push something (depending on your trigger). Jenkins will automagically run.
### Maven projects
* Now let's add both Git and Maven to Jenkins:
* First start by manually installing them by using `apt-get install git maven openjdk-8-jdk`;
* Now use `which git` to find out where git is installed (`/usr/bin/git`);
* Use `whereis maven` to find where maven's home directory is (`/usr/share/maven`);
* Go to [jenkins.mphslaats.com/configureTools](https://jenkins.mphslaats.com/configureTools) and add the git, maven and jdk (`/usr/lib/jvm/default-java`) directories;
* To make full use of Maven go to [jenkins.mphslaats.com/pluginManager/available](https://jenkins.mphslaats.com/pluginManager/available) and add Maven Intergration.
### Config files
If you want to use config files in your build process without passwords leaking, add the [Config File Provider Plugin](https://wiki.jenkins-ci.org/display/JENKINS/Config+File+Provider+Plugin).
After installing this plugin you can go to `Manage Jenkins`. Here you find a section `Manage files`, in here you can add and edit configuration files.
If you now go to your preferred Jenkins job, you can a configuration file as a Pre Step by adding `Provide confuration files`.
## Installed plugins
You can search for new plugins [here](https://plugins.jenkins.io/).
* [Maven Integration](https://plugins.jenkins.io/maven-plugin): Needed to be able to create Maven items in Jenkins;
......@@ -71,4 +77,5 @@ You can search for new plugins [here](https://plugins.jenkins.io/).
* [Green Balls](https://plugins.jenkins.io/greenballs): Makes the success balls green;
* [GitLab Plugin](https://plugins.jenkins.io/gitlab-plugin): Plugin to be able to trigger Jenkins after Gitlab push;
* [Blue Ocean Plugin](https://wiki.jenkins.io/display/JENKINS/Blue+Ocean+Plugin): For a more elegant GUI;
* [JaCoCo Plugin](https://wiki.jenkins.io/display/JENKINS/JaCoCo+Plugin): To show the test coverage.
\ No newline at end of file
* [JaCoCo Plugin](https://wiki.jenkins.io/display/JENKINS/JaCoCo+Plugin): To show the test coverage;
* [Config File Provider Plugin](https://wiki.jenkins-ci.org/display/JENKINS/Config+File+Provider+Plugin): To provide config files to your jobs.
\ No newline at end of file