01 Grundlegende Syntax von Pipeline
Erstellen Sie zuerst eine Pipeline-Aufgabe, die eine Pipeline auf Jenkins erstellt
Neues ITEM->Pipeline auswählen
Grundlegende Pipeline-Skriptstruktur
Pipeline {
//agent 表示要执行的节点，any表示任意节点
Agent irgendein
//stages stellt eine Sammlung aller Schritte dar, wenn die Aufgabe ausgeführt wird
Stufen {
//stage就表示一个步骤，括号里是步骤名称
stage('拉取项目源码'){
//每一个stage都可以定义自己执行的节点，如果没定义，则用最上方的
agent {
// label 后跟的是节点的标签名称
label 'mall-server'
}
steps {
echo '这是拉取代码这一步'
echo "Running ${env.BUILD_ID} on ${env.JENKINS_URL} ${env.JOB_NAME}"
echo "${currentBuild.result} sdsdd"
sh 'pwd'
//如果当前节点是windows，我想执行windows下的命令
//bat 'dir'
}
}
stage('静态代码扫描'){
steps {
echo '这是静态代码扫描'
}
}
stage('单元测试'){
steps {
echo '执行jacoco单元测试'
}
}
stage('打包依赖服务'){
steps {
echo '打包依赖服务'
}
}
stage('打包当前服务'){
steps {
echo '打包当前服务'
}
}
stage('部署环境'){
steps {
echo '部署环境'
}
}
stage('接口自动化测试'){
agent {
label 'auto_test'
}
steps {
echo '接口自动化测试'
}
}
stage('ui自动化'){
steps {
echo 'ui自动化'
}
}
}
}
02 Schreiben Sie ein Pipeline-Skript für das Mall-Microservice-Projekt
Für das Pipeline-Skript müssen wir uns nicht so viele Dinge merken, wir können unsere eigene Pipeline-Aufgabe öffnen, auf die Pipeline-Syntax klicken und die folgenden beiden Menüs verwenden, um uns beim Generieren einiger Skripts zu helfen
Für ein Projekt kann es mehrere Dienste und mehrere Umgebungen geben.
Wir müssen also Umgebungsknotenparameter und Dienstnamenparameter erstellen
Fügen Sie oben im Pipeline-Skript Folgendes hinzu:
//Zwei Sätze von Optionsparametern definieren
parameter { Auswahlmöglichkeiten: ['mall-admin', 'mall-demo', 'mall-auth', 'mall-serach'], name:'servername' Wahlmöglichkeiten: ['mall -server', 'mall-dev', 'mall-prod'], Name: 'node_env' }
Führen Sie nach Abschluss der Konfiguration zunächst eine Aufgabe aus
Wählen Sie den Knoten aus, auf dem das Projekt bereitgestellt wird
Da die bereitgestellte Knotenumgebung auf den Parametern des vorherigen Schritts basiert, werden wir ausführen, was auch immer der Benutzer auswählt, sodass der Wert von label eine Variable ist
Agent {
label "${node_env}"
}
Projektcode ziehen
Kopieren Sie das generierte Skript und fügen Sie es in der Phase des Abrufens des Codes unter Schritte ein
stage('Projektquellcode abrufen'){
steps {
echo '这是拉取代码这一步'
git credentialsId: '4c1003ef-ac70-4271-8649-1759e79d430a', url: 'http://192.168.0.109/shamo/mall-swarm-master.git'
}
}
Unit-Test-Abdeckung
Da das Mall-Projekt ursprünglich keine jacoco-bezogenen Abdeckungsstatistiken integriert hatte, haben wir zunächst einige Änderungen am Projekt vorgenommen
① Ändern Sie die Datei pom.xml im Stammverzeichnis des gesamten Projekts
FALSCH
② Ändern Sie die pom.xml jedes Submoduldienstes
org.jacoco <artifactId>jacoco-maven-plugin</artifactId>
<version>0.8.6</version>
<groupId>org.jacoco</groupId>
<artifactId>jacoco-maven-plugin</artifactId>
<version>0.8.6</version>
<configuration>
<destFile>target/coverage-reports/jacoco-unit.exec</destFile>
<dataFile>target/coverage-reports/jacoco-unit.exec</dataFile>
</configuration>
<executions>
<execution>
<id>jacoco-initialize</id>
<goals>
<goal>prepare-agent</goal>
</goals>
</execution>
<execution>
<id>jacoco-site</id>
<phase>test</phase>
<goals>
<goal>report</goal>
</goals>
</execution>
</executions>
③ Schreiben Sie eine Pipeline
Kopieren Sie die generierte jacoco-Anweisung und füllen Sie die entsprechenden Schritte aus
stage('Einheitentest'){
steps {
echo '执行jacoco单元测试'
sh '''
cd "${servername}"
mvn test
'''
jacoco changeBuildStatus: true,
maximumBranchCoverage: '100',
maximumClassCoverage: '100',
maximumComplexityCoverage: '100',
maximumInstructionCoverage: '100',
maximumLineCoverage: '100',
maximumMethodCoverage: '100',
minimumBranchCoverage: '90',
minimumClassCoverage: '90',
minimumComplexityCoverage: '90',
minimumInstructionCoverage: '90',
minimumLineCoverage: '90',
minimumMethodCoverage: '90'
}
}
Statisches Scannen von Codes
Kopieren Sie die generierten in die Schritte der Phase des statischen Scans und fügen Sie dann die Sonar-Scan-Anweisungen hinzu
stage('Statischer Code-Scan'){
steps {
echo '这是静态代码扫描'
withSonarQubeEnv(credentialsId: '1d74c7e8-5b27-4772-9a21-41e17eb87b7d', installationName: 'sonar') {
// 执行sonar扫描的指令
sh '''
cd "${servername}"
mvn sonar:sonar \
-Dsonar.projectKey=${JOB_NAME}-${servername}$BUILD_NUMBER \
-Dsonar.projectName=mall \
-Dsonar.language=java \
-Dsonar.sourceEncoding=UTF-8 \
'''
}
}
}
paketieren und bereitstellen
stage('Dienstpaket und Bereitstellung'){
steps {
echo '打包依赖服务'
//打包每个服务都依赖的模块
sh 'mvn clean install -pl mall-common,mall-mbg -am'
//打包我要部署的这个服务模块
sh '''
cd "${servername}"
mvn clean package
'''
//执行部署脚本文件
sh '/mydata/sh/${servername}.sh'
}
}
Dinging-Benachrichtigung
DingTalk-Benachrichtigungen können tatsächlich in jeder Phase hinzugefügt werden, wir laden sie in die Bereitstellung
stage('Dienstpaket und Bereitstellung'){
steps {
echo '打包依赖服务'
//打包每个服务都依赖的模块
sh 'mvn clean install -pl mall-common,mall-mbg -am'
//打包我要部署的这个服务模块
sh '''
cd "${servername}"
mvn clean package
'''
//执行部署脚本文件
sh '/mydata/sh/${servername}.sh'
//部署完成后钉钉通知项目组
dingtalk(
robot:'dd001',//robot指的是你在系统配置中配的钉钉机器人的id
type:'MARKDOWN',
atAll: false,
title: "${servername} 部署成功",
text: ["#### '${JOB_NAME}'项目扫描部署 \n - 任务：第'${BUILD_NUMBER}'次\n - 状态：'${currentBuild.result}' \n - 执行人: '${user}' \n \n[查看控制台]('${BUILD_URL}')"]
)
}
}
Konfigurieren Sie automatisierte Aufgaben
Das Skript des Allure-Plugins wird wie folgt generiert:
Das Skript für die E-Mail wird wie folgt generiert:
stage('Schnittstellenautomatisierungstest'){
//如果之前的步骤执行时失败了改动了当前任务的结果，那么自动化测试没有必要执行
//下面的判断指的是没结果时或者结果是成功时
when {
expression {
currentBuild.result==null||currentBuild.result == 'SUCCESS'
}
}
//使用自动化执行的节点
agent {
label 'auto_test'
}
steps {
echo '接口自动化测试'
//拉取自动化脚本
git credentialsId:'4c1003efac70-4271-8649-1759e79d430a', url: 'http://192.168.0.109/shamo/mallapitest1.git'
//执行自动化测试，由于这个节点是windows的，所以采用bat xxx来执行命令操作
bat 'python run.py'
//生成测试报告
allure includeProperties: false, jdk: '', results: [[path: 'report/shop']]
//发送结果邮件
emailext body: '''<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>$PROJECT_NAME-第$BUILD_NUMBER次构建日志</title>
</head>
<body leftmargin="8" marginwidth="0" topmargin="8" marginheight="4" offset="0">
<div>
<table width="95%" cellpadding="0" cellspacing="0" style="font-size: 11pt; font-family: Tahoma, Arial, Helvetica, sans-serif">
<tr>
<th colspan="2"><br />
<h2>构建信息</h2>
</th>
</tr>
<tr>
<td>
<ul>
<li>项目名称 ：$PROJECT_NAME</li><br />
<li>详细测试日志 ：<a href=${BUILD_URL}console target=\'_blank\'>${BUILD_URL}console</a></li><br />
<li>详细测试报告 ：<a href=${JOB_URL}${$BUILD_NUMBER}/allure target=\'_blank\'>${JOB_URL}${$BUILD_NUMBER}/allure</a></li><br />
<li>触发原因：${CAUSE}</li><br />
<li>项目 Url ：<a href=‘$BUILD_URL’ target=\'_blank\'>$BUILD_URL</a></li><br />
</ul>
</td>
</tr>
</table>
</div>
</body>
</html>''',
subject: '$PROJECT_NAME - Build # $BUILD_NUMBER - $BUILD_STATUS!', to: '[email protected]'
}
}
endgültige Ausführung
Chinesische Online-Dokumentation: https://www.jenkins.io/zh/doc/book/pipeline/
und eine weitere: https://www.w3cschool.cn/jenkins/jenkins-qc8a28op.html