Gitlab + CI Inria (Jenkins)

• avoir déjà configurer un projet CI sur la plate-forme nationale
• connaître un peu Gitlab ou la forge

• récuperer un projet Gitlab sur ses esclaves
• activer un déclic «post-commit» pour lancer la compilation sur Jenkins
• afficher un rapport de test ou de compilation avec un badge dans le README.md
• utiliser succintement les «pipelines» Jenkins

autre MDB)

• les outils CI de Gitlab (orchestration coté Gitlab)

Dans Jenkins :

• installer l'extension "GitLab Plugin"
• créer un job, par exemple un projet free-style
  • dans la section Gestion de code source, cocher Git et ajouter l'URL de votre dépôt Git
    • par exemple git@gitlab.inria.fr:fuentes/testgitlabCI.git
    • ignorer le message d'erreur, si vous avez bien déployé la clef SSH sur les esclaves et sur GitLab l'accès au dépôt fonctionnera

• dans la section Ce qui déclenche le build (triggers), cocher Build when a change is pushed to GitLab. et copier l'adresse suivant GitLab CI Service URL:

• ensuite aller dans Avancé…
• et génerer un Secret token (cliquer sur Generate)
• puis copier le code

Dans GitLab :

• aller dans les paramètres du projet (engrenage à droite) puis dans Integrations
• ici coller l'adresse GitLab Service URL précédemment copiée
• ainsi que le Secret token

• cocher les cases évènements déclencheur de build qui vous intéressent

Grâce à ce mécanisme le job Jenkins associé sera déclenché dès lors qu'un des évènements choisi dans Trigger aura lieu.

Dans Jenkins :

• installer le greffon "Gitlab Merge Request Builder"
• configurer cf. https://github.com/timols/jenkins-gitlab-merge-request-builder-plugin, section Installation
• créer un job Jenkins cf. https://github.com/timols/jenkins-gitlab-merge-request-builder-plugin, section Creating a Job
  • dans la partie Ce qui déclenche le build en plus de cocher et paramétrer Gitlab Merge Requests Builder, penser à cocher aussi Build when a change is pushed to GitLab et paramétrer comme précedemment en générant un token associé à ce job qui sera ensuite copié dans le partie Integration -> webhooks de Gitlab. Ajouter bien "merge request events" à la liste des évènements déclencheurs

• via le greffon Gitlab, on a accès à de nouvelles fonctionnalités dans la section Add Post-build action, on peut selectionner Publish build status to GitLab commit, ce qui informera Gitlab lors d'une compilation réussie.
• on peut ajouter un badge dans le README.md avec une ligne du genre

[![Build status](https://gitlab.inria.fr/fuentes/testgitlabCI/badges/master/build.svg)](https://gitlab.inria.fr/fuentes/testgitlabCI/commits/master)

• avec Jenkins >=2.x , on peut faire aussi le même travail en nettement moins de clics , en utilisant le greffon pipeline qui se présente sous la forme

avec une syntax Groovy

node {
   stage 'Checkout'
   checkout([$class: 'GitSCM', branches: [[name: '*/master']], doGenerateSubmoduleConfigurations: false, extensions: [],
   submoduleCfg: [], userRemoteConfigs: [[url: 'git@gitlab.inria.fr:fuentes/testgitlabCI.git']]])
   gitlabBuilds(builds: ["configure","build", "test"]) {
       stage "configure"
       gitlabCommitStatus("configure") {
	    sh 'mkdir -p build && cd build && cmake ..'
       }
       stage "build"
       gitlabCommitStatus("build") {
	   sh 'cd build && make '
       }
       stage "test"
       gitlabCommitStatus("test") {
	   sh 'cd build && ctest'
       }
   }
}

• pour découvrir la syntaxe Groovy associée à une étape, on peut utiliser l'outil Pipeline Syntax après compilation on obtient des comptes-rendus agréables cotés Jenkins