“Jenkins Pipeline (or simply “Pipeline” with a capital “P”) is a suite of plugins which supports implementing and integrating continuous delivery pipelines<\/em> into Jenkins.
A continuous delivery (CD) pipeline<\/em> is an automated expression of your process for getting software from version control right through to your users and customers. Every change to your software (committed in source control) goes through a complex process on its way to being released. This process involves building the software in a reliable and repeatable manner, as well as progressing the built software (called a “build”) through multiple stages of testing and deployment. “<\/p>\n\n\n\n
With this specific process, you will be able to create a list of tasks to be executed.<\/p>\n\n\n\n
How to start ?<\/h2>\n\n\n\n
A Jenkins Pipeline always start with the node<\/em> function. <\/p>\n\n\n\n This simple Pipeline will only print “Hello World !”.<\/p>\n\n\n\n Before configuring Pipeline, you will have to configure your Jenkins environment.<\/p>\n\n\n\n On your SonarQube interface, create a new user (named it jenkins<\/em>). Connect to SonarQube with jenkins <\/em>credentials and generate an new authentication token (accessible from the “My Account” menu).<\/p>\n\n\n\n The token will be displayed after setting a new token name and clicked on “Generate”. Copy it, you will need it to configure SonarQube in Jenkins.<\/p>\n\n\n\n On your Git interface, create a new user and affect it to your Git repository as developer.<\/p>\n\n\n\n Back to Jenkins. Go into “Manage Jenkins” then “Configure System”<\/p>\n\n\n\n Add a new SonarQube server. Check the “Enable injection of SonarQube server configuration as build environment variables” checkbox, set the name to “SonarQube”, the server URL to the \/sonarqube endpoint, and the authentication token from the previously generated token. When it’s done, click on “Save”.<\/p>\n\n\n\n When it’s done, click on “Manage Jenkins” > “Managed files”. Add a new Maven configuration file matching with your environment, and name it “Maven Settings”, then click “Submit”.<\/p>\n\n\n\n When the maven file is configured, let’s configure Jenkins tools. Click on “Manage Jenkins” and “Global Tools Configuration”.<\/p>\n\n\n\n Configure the “Maven Configuration” part as the following:<\/p>\n\n\n\n Configure the “Git” part as the following:<\/p>\n\n\n\n Configure the “SonarQube Server” part as the following:<\/p>\n\n\n\n Configure the “Maven” part as the following:<\/p>\n\n\n\n When all is configured, click on “Save”. You are now ready to go with the Pipeline part !<\/p>\n\n\n\n Create a new Jenkins Job. Named it “My Pipeline”, click on the Pipeline wizard, and click on “OK”.<\/p>\n\n\n\n In the “Build Triggers” part, you can configure when the job is launch. For my personal use, I will check the “Build periodically” check box, and set the “Schedule” part to “H H * * *” (one execution per day).<\/p>\n\n\n\n Then the Pipeline script. Set the “Definition” value to “Pipeline script” (I will write my script in Jenkins instead of a SCM file available on Git repository), and let’s go to the Pipeline !<\/p>\n\n\n\n Firstly, let’s prepare our environment. Here is the preparation stage:<\/p>\n\n\n\n This stage will clean the Job workspace on each execution, and will checkout my “master” Git branch using specific credentials (based on credentials id) from a specific url. I will also add to the PATH environment my Maven informations (here, ‘Maven3’ must match the Maven tool name you set previously).<\/p>\n\n\n\n Second stage, compiling all my sources:<\/p>\n\n\n\n Here, I specify my configuration file using the “configFileProvider” function, fileId matching my “Managed Files” configuration.<\/p>\n\n\n\n Third stage, my SonarQube execution. Based on Maven, I will just invoke the “sonar:sonar” goal:<\/p>\n\n\n\n Same as the “Build” stage, I specified my SonarQube installation using the “withSonarQubeEnv” function (“SonarQube” is my actual installation name), and I run my SonarQube analysis by calling sh ‘mvn -s $MAVEN_SETTINGS org.sonarsource.scanner.maven:sonar-maven-plugin:3.2:sonar’.<\/p>\n\n\n\n Next stage, the Quality Gate:<\/p>\n\n\n\n Will wait 1 hour for SonarQube execution.<\/p>\n\n\n\n You can also add a “Result” stage, if you want to do something when all stages were executed well:<\/p>\n\n\n\n Your global Pipeline must look as the following:<\/p>\n\n\n\n And voila ! Your Pipeline is now ready to run ! A first execution will result to the following:<\/p>\n\n\n\n Your Pipeline execution is successfull, your report is available in your SonarQube application, and your compilation packages can be retrieved by accessing your last execution, clicking on “Pipeline Steps”, “Allocate node : Start” and “Workspace”.<\/p>\n","protected":false},"excerpt":{"rendered":" Continous integration is, in computer sciences, a must-have. Jenkins help us to reach this objectives. But how to configure it using “Pipelines” ?<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[16],"tags":[],"class_list":["post-238","post","type-post","status-publish","format-standard","hentry","category-jenkins"],"_links":{"self":[{"href":"https:\/\/blog.xoupix.fr\/index.php\/wp-json\/wp\/v2\/posts\/238","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.xoupix.fr\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.xoupix.fr\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.xoupix.fr\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.xoupix.fr\/index.php\/wp-json\/wp\/v2\/comments?post=238"}],"version-history":[{"count":3,"href":"https:\/\/blog.xoupix.fr\/index.php\/wp-json\/wp\/v2\/posts\/238\/revisions"}],"predecessor-version":[{"id":254,"href":"https:\/\/blog.xoupix.fr\/index.php\/wp-json\/wp\/v2\/posts\/238\/revisions\/254"}],"wp:attachment":[{"href":"https:\/\/blog.xoupix.fr\/index.php\/wp-json\/wp\/v2\/media?parent=238"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.xoupix.fr\/index.php\/wp-json\/wp\/v2\/categories?post=238"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.xoupix.fr\/index.php\/wp-json\/wp\/v2\/tags?post=238"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}node {\n echo \"Hello World !\"\n}<\/code><\/pre>\n\n\n\nLet”s go deeper : Git + Maven + Sonar<\/h2>\n\n\n\n
Preparing Sonar environment<\/h3>\n\n\n\n
![\"\"](\"https:\/\/blog.xoupix.fr\/wp-content\/uploads\/2019\/03\/2019-03-01-09_19_27-Security-My-Account.png\")
<\/figure>\n\n\n\nPreparing git environment<\/h3>\n\n\n\n
Preparing Jenkins environment<\/h3>\n\n\n\n
![\"\"](\"https:\/\/blog.xoupix.fr\/wp-content\/uploads\/2019\/03\/2019-03-01-09_22_51-Manage-Jenkins-Jenkins.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/blog.xoupix.fr\/wp-content\/uploads\/2019\/03\/2019-03-01-09_26_18-Configure-System-Jenkins.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/blog.xoupix.fr\/wp-content\/uploads\/2019\/03\/2019-03-01-22_13_52-Jenkins.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/blog.xoupix.fr\/wp-content\/uploads\/2019\/03\/2019-03-01-22_14_58-Manage-Jenkins-Jenkins.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/blog.xoupix.fr\/wp-content\/uploads\/2019\/03\/2019-03-01-22_18_14-Global-Tool-Configuration-Jenkins.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/blog.xoupix.fr\/wp-content\/uploads\/2019\/03\/2019-03-01-22_19_04-Global-Tool-Configuration-Jenkins.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/blog.xoupix.fr\/wp-content\/uploads\/2019\/03\/2019-03-01-22_20_59-Global-Tool-Configuration-Jenkins.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/blog.xoupix.fr\/wp-content\/uploads\/2019\/03\/2019-03-01-22_21_53-Global-Tool-Configuration-Jenkins.png\")
<\/figure>\n\n\n\nDefining a new Jenkins Job<\/h3>\n\n\n\n
![\"\"](\"https:\/\/blog.xoupix.fr\/wp-content\/uploads\/2019\/03\/2019-03-01-22_25_03-New-Item-Jenkins-1024x860.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/blog.xoupix.fr\/wp-content\/uploads\/2019\/03\/2019-03-01-22_29_06-BouyguesTelecom-Pipeline-Config-Jenkins.png\")
<\/figure>\n\n\n\nPreparation stage<\/h4>\n\n\n\n
stage('Preparation') { \/\/ for display purposes\n \/\/ Cleaning workspace\n cleanWs()\n \/\/ Get some code from Git\n git branch: 'master', \n credentialsId: 'e65361e0-6bc0-4de3-8041-d22b44e6d3b3',\n url: 'http:\/\/git-server\/gitlab\/repository.git'\n \/\/ Get the Maven tool.\n env.PATH = \"${tool 'Maven3'}\/bin:${env.PATH}\"\n }<\/code><\/pre>\n\n\n\n stage('Build') {\n \/\/ Run the maven build\n configFileProvider(\n [configFile(fileId: 'MavenSettings', variable: 'MAVEN_SETTINGS')]) {\n\t\ttry {\n sh 'mvn -s $MAVEN_SETTINGS clean package -Dmaven.test.skip=true'\n\t\t} catch (err) {\n\t\t echo \"Error while compiling projects\"\n\t\t}\n }\n }<\/code><\/pre>\n\n\n\n stage('SonarQube analysis') {\n withSonarQubeEnv('SonarQube') {\n \/\/ requires SonarQube Scanner for Maven 3.2+\n\t \n configFileProvider([configFile(fileId: 'MavenSettings', variable: 'MAVEN_SETTINGS')]) {\n\t\t try {\n sh 'mvn -s $MAVEN_SETTINGS org.sonarsource.scanner.maven:sonar-maven-plugin:3.2:sonar'\n\t\t } catch (err) {\n\t\t echo \"Error while processing sonar on projects\"\n\t\t }\n }\n }\n }<\/code><\/pre>\n\n\n\n stage(\"Quality Gate\"){\n timeout(time: 1, unit: 'HOURS') { \/\/ Just in case something goes wrong, pipeline will be killed after a timeout\n def qg = waitForQualityGate() \/\/ Reuse taskId previously collected by withSonarQubeEnv\n if (qg.status != 'OK') {\n error \"Pipeline aborted due to quality gate failure: ${qg.status}\"\n }\n }\n }<\/code><\/pre>\n\n\n\n stage('Results') {\n \n }<\/code><\/pre>\n\n\n\nnode {\n def mvnHome\n stage('Preparation') { \/\/ for display purposes\n \/\/ Cleaning workspace\n cleanWs()\n \/\/ Get some code from Git\n git branch: 'master', \n credentialsId: 'e65361e0-6bc0-4de3-8041-d22b44e6d3b3',\n url: 'http:\/\/git-server\/gitlab\/repository.git'\n \/\/ Get the Maven tool.\n env.PATH = \"${tool 'Maven3'}\/bin:${env.PATH}\"\n }\n stage('Build') {\n \/\/ Run the maven build\n configFileProvider(\n [configFile(fileId: 'MavenSettings', variable: 'MAVEN_SETTINGS')]) {\n\t\ttry {\n sh 'mvn -s $MAVEN_SETTINGS clean package -Dmaven.test.skip=true'\n\t\t} catch (err) {\n\t\t echo \"Error while compiling projects\"\n\t\t}\n }\n }\n stage('SonarQube analysis') {\n withSonarQubeEnv('SonarQube Production Line') {\n \/\/ requires SonarQube Scanner for Maven 3.2+\n\t \n configFileProvider([configFile(fileId: 'MavenSettings', variable: 'MAVEN_SETTINGS')]) {\n\t\t try {\n sh 'mvn -s $MAVEN_SETTINGS org.sonarsource.scanner.maven:sonar-maven-plugin:3.2:sonar'\n\t\t } catch (err) {\n\t\t echo \"Error while processing sonar on projects\"\n\t\t }\n }\n }\n }\n stage(\"Quality Gate\"){\n timeout(time: 1, unit: 'HOURS') { \/\/ Just in case something goes wrong, pipeline will be killed after a timeout\n def qg = waitForQualityGate() \/\/ Reuse taskId previously collected by withSonarQubeEnv\n if (qg.status != 'OK') {\n error \"Pipeline aborted due to quality gate failure: ${qg.status}\"\n }\n }\n }\n stage('Results') {\n \n }\n}<\/code><\/pre>\n\n\n\n![\"\"](\"https:\/\/blog.xoupix.fr\/wp-content\/uploads\/2019\/03\/2019-03-01-22_51_29-BouyguesTelecom-Pipeline-Jenkins.png\")
<\/figure>\n\n\n\n