Complete build instructions with easy-jenkins

docs/BUILD-WITH-EASY-JENKINS.md

@@ -1,5 +1,51 @@
 # Building Mooseca with easy-jenkins
 
-TODO
+This document explains how to setup a [Jenkins](https://jenkins.io/) pipeline for performing CI/CD of the Mooseca project.
+
+### Prerequisites
+
+Please refer to section "System Requirements" of <https://github.com/gmacario/my-jenkins-pipelines>
+
+#### Install easy-jenkins
+
+Follow instructions at <https://github.com/gmacario/easy-jenkins>
+
+Configure the initial administrator account - example:
+
+* Username: `admin`
+* Password `xxxx`
+* Confirm password `xxxx`
+* Full name `Admin (myhost)`
+* E-mail address `admin@myhost.example.com`
+
+#### Post-install configuration
+
+Browse `${JENKINS_DASHBOARD}` (in my case <http://myhost.example.com:9080>)
+
+Click on **Build Executor Status**, then click on the "Configure" icon of node `master`
+
+* Number of executors: 8 (was 2)
+* Labels: `docker`
+
+then click **Save**.
+
+### Install pipeline `TinyTanic/mooseca`
+
+Browse `${JENKINS_DASHBOARD}` and click **Open Blue Ocean**.
+
+Click **New Pipeline** to start the Blue Ocean pipeline creation wizard.
+
+* Where do you store your code? **Github**
+* Connect to Github: Create an access key
+  - Token description: `easy-jenkins @myhost`
+  - Select scopes: Accept defaults (repo:all, read:user, user:email)
+  - Click **Generate token**
+* Click icon to copy your new personal access token
+* On the Jenkins pipeline setup page, paste your Github access token and click **Connect**
+* Which organization does the repository belong to? **TinyTanic**
+* Create a single Pipeline or discover all Pipelines: **New Pipeline**
+* Choose a repository: `mooseca`, then click **Create Pipeline**
+* Wait until the "Completed" status is displayed
+* Enjoy!
 
 <!-- EOF -->