在统信UOS上搭建Jenkins CI流水线需依次完成：确认x86_64/arm64架构、安装OpenJDK 11、添加统信Jenkins源、安装启用服务、配置初始密码；再在全局工具中设置JDK/Maven/Node.js、添加Git凭据；最后通过Jenkinsfile声明式Pipeline实现自动拉取、编译、归档。
在统信UOS系统上为Java或前端项目搭建可投入生产的Jenkins自动化持续集成流水线，需先完成服务部署、工具链绑定、凭证配置三重基础，再编写可追溯的声明式Pipeline脚本，确保每次代码提交后自动拉取→编译→测试→归档产物，全程无需人工干预。
安装Jenkins服务并验证运行状态
推荐使用APT源方式安装，该路径适配UOS内核与安全策略，避免因通用Debian源导致Web界面白屏或流水线执行中断。
第一步：确认系统架构，执行uname -m，输出必须为【x86_64 或 arm64】；若为arm64，后续所有URL中的amd64需手动替换为arm64，否则安装包无法解压运行。
第二步：安装OpenJDK 11，执行sudo apt update && sudo apt install -y openjdk-11-jdk。这一步不可跳过——UOS默认未预装JDK 11，直接装Jenkins会因Java环境缺失导致服务启动后立即退出。
第三步：导入密钥并添加官方源，依次执行：
wget -qO- https://mirrors.uniontech.com/jenkins/debian/jenkins.io.key | sudo gpg --dearmor -o /usr/share/keyrings/jenkins-keyring.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/jenkins-keyring.gpg] https://mirrors.uniontech.com/jenkins/debian-stable binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list
第四步：安装并启用服务，执行sudo apt update && sudo apt install -y jenkins && sudo systemctl enable --now jenkins。服务启动后，用sudo systemctl status jenkins检查状态，出现【active (running)】即表示成功。
第五步：访问http://localhost:8080，终端执行sudo cat /var/lib/jenkins/secrets/initialAdminPassword获取初始密码并粘贴登录。
配置全局工具链与凭据管理
这一步决定后续流水线能否正确调用Maven、Node.js或Git命令——工具路径填错会导致构建步骤直接报“command not found”。
方法一：配置JDK与Maven（适用于Java项目）
进入Jenkins主界面→Manage Jenkins → Global Tool Configuration→在JDK栏点击“Add JDK”→取消勾选“Install automatically”，手动填写JAVA_HOME路径（通常为/usr/lib/jvm/java-11-openjdk-amd64）；同理，在Maven栏点击“Add Maven”，Name填Maven-3.8.6，MAVEN_HOME填/usr/share/maven（若未安装则先执行sudo apt install maven）。
方法二：配置Node.js（适用于Vue/React项目）
在Global Tool Configuration页面→NodeJS栏→点击“Add NodeJS”→Name填Node-18.18.2→勾选“Install automatically”，Version选择18.18.2→保存后首次构建时将自动下载并解压到/var/lib/jenkins/tools/jenkins.plugins.nodejs.tools.NodeJSInstallation/Node-18.18.2。
方法三：添加Git凭据（必做）
进入Credentials → System → Global credentials → Add Credentials→Kind选择Username with password→Scope选Global→Username填Git平台账号（如gitee用户名），Password填个人访问令牌（PAT，非登录密码）→ID建议设为git-credential，便于后续Pipeline中引用。
编写并运行第一条声明式流水线
流水线脚本必须存放在项目根目录的Jenkinsfile中，内容不写对会导致构建失败且无明确报错提示。
第一步：在代码仓库根目录创建Jenkinsfile文件，内容如下：
pipeline {
agent any
tools {
maven 'Maven-3.8.6'
}
stages {
stage('Checkout') {
steps {
checkout scmGit(branches: [[name: '*/main']], extensions: [], userRemoteConfigs: [[credentialsId: 'git-credential', url: 'https://gitee.com/yourname/yourproject.git']])
}
}
stage('Build') {
steps {
sh 'mvn clean package -DskipTests'
}
}
stage('Archive') {
steps {
archiveArtifacts artifacts: 'target/*.jar', fingerprint: true
}
}
}
}
第二步：在Jenkins中新建任务→选择Pipeline类型→勾选GitHub project并填写项目URL→在Pipeline配置区→Definition选Pipeline script from SCM→SCM选Git→Repository URL填同上Git地址→Credentials选刚创建的git-credential→Script Path填Jenkinsfile。
第三步：点击Save→返回任务首页→点击立即构建。构建日志中出现[INFO] BUILD SUCCESS且左侧“构建历史”显示蓝色球体，即表示流水线已成功运行。
