使用 Jenkins 构建 .NET 微服务的持续集成/持续交付（CI/CD）流水线，核心在于自动化代码拉取、编译、测试、打包和部署。Jenkins 凭借其强大的插件生态和灵活性，非常适合处理 .NET 项目，尤其是基于 .NET Core/.NET 5+ 的微服务架构。
1. 准备环境与依赖
确保 Jenkins 所在节点具备运行 .NET 项目的必要条件：
.NET SDK 安装：在 Jenkins 主节点或构建节点上安装对应版本的 .NET SDK（如 6.0、7.0）。可通过官方包管理器或手动安装。 Jenkins 插件配置：安装关键插件，包括： Git：用于拉取源码 Pipeline：支持声明式或脚本式流水线 Docker Pipeline（可选）：若需构建镜像 MSBuild 或 DotNet Core Pipeline：简化 .NET 命令调用 凭据管理：在 Jenkins 凭据存储中配置 Git 账号、NuGet 私有源、Docker Registry 登录信息等。2. 创建 Jenkinsfile 定义流水线
在微服务代码根目录下添加 Jenkinsfile，使用声明式语法定义全流程。以下是一个典型示例：
pipeline {
agent any
environment {
SERVICE_NAME = 'user-service'
DOTNET_VERSION = '6.0'
}
stages {
stage('Checkout') {
steps {
git branch: 'main', url: 'https://github.com/yourorg/user-service.git'
}
}
stage('Restore Dependencies') {
steps {
sh 'dotnet restore'
}
}
stage('Build') {
steps {
sh 'dotnet build --configuration Release --no-restore'
}
}
stage('Run Tests') {
steps {
sh 'dotnet test --configuration Release --no-build --verbosity normal'
}
}
stage('Publish') {
steps {
sh 'dotnet publish -c Release -o ./publish'
}
}
stage('Build Docker Image') {
when {
expression { env.BRANCH_NAME == 'main' }
}
steps {
script {
docker.build("${env.SERVICE_NAME}:${env.BUILD_ID}")
}
}
}
stage('Deploy to Staging') {
when {
expression { env.BRANCH_NAME == 'main' }
}
steps {
sh 'kubectl apply -f k8s/staging/ -n staging'
}
}
}
post {
success {
echo 'Pipeline succeeded!'
}
failure {
echo 'Pipeline failed!'
}
}
}
3. 配置 Jenkins Job 并触发构建
在 Jenkins 界面创建“流水线”类型任务：
在“流水线”部分选择“从 SCM 读取”，指定代码仓库和 Jenkinsfile 路径。 设置构建触发器，例如： GitHub Webhook：推送代码后自动触发 定时构建：定期执行（如 nightly build） 保存后手动运行一次，验证各阶段是否正常。4. 集成测试与部署策略
增强流水线的健壮性和安全性：
单元测试与覆盖率：使用 xUnit/NUnit + ReportGenerator 生成测试报告，通过 junit 和 publishCoverage 步骤展示结果。 多环境部署：通过参数化构建或分支判断，部署到 dev/staging/prod 环境。生产发布可加入人工确认（input 指令）。 镜像推送：在构建镜像后，使用 docker.withRegistry 推送至私有或公有镜像仓库。 通知机制：集成邮件、企业微信或钉钉，在构建失败时及时告警。 基本上就这些。只要环境准备好，Jenkinsfile 写清楚，.NET 微服务的 CI/CD 流程就能稳定跑起来。关键是把每个阶段拆解明确，逐步验证。
