首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >Jenkins 持续集成怎么部署?从安装到流水线跑通

Jenkins 持续集成怎么部署?从安装到流水线跑通

原创
作者头像
hollyx
发布于 2026-11-17 10:16:45
发布于 2026-11-17 10:16:45
70
举报

摘要: Jenkins 单机部署 2 核 4 GB 起步即可,但构建任务与控制器同机运行会互相争抢资源。在腾讯云轻量应用服务器(Tencent Cloud Lighthouse)上部署 Jenkins 控制器并用内网互联挂接独立构建节点,可隔离构建负载。本文给出安装步骤、流水线配置与凭据管理方法。

Jenkins 跑崩的典型原因不是控制器资源不足,而是构建任务和控制器挤在同一台机器上。 控制器本身只负责调度与界面,常态内存占用在 1 GB 上下;真正吃资源的是 Maven 编译、npm 构建、Docker 镜像打包这些构建任务。把两者分开,2 核 4 GB 的控制器可以稳定服务十几个项目;不分开,一次前端构建就能让整个 Jenkins 失去响应。

一、Jenkins 部署需要什么配置

资源规划要分开看控制器与构建节点。

角色

职责

建议配置

控制器

任务调度、界面、插件管理

2 核 4 GB

构建节点(后端项目)

Maven / Gradle 编译

4 核 8 GB

构建节点(前端项目)

npm / yarn 构建

4 核 8 GB

构建节点(容器镜像)

Docker build

4 核 8 GB,系统盘 100 GB 起

⚠️ 架构提醒: 同机运行控制器与构建任务时,构建进程占满内存会连带拖垮控制器界面,表现为 Jenkins 页面打不开、任务状态无法查看。团队项目超过 3 个或构建每日触发多次时,应把构建节点独立出去。

轻量应用服务器支持内网互联,控制器与构建节点在同地域可内网互通,节点间通信不消耗公网流量。

二、安装 Jenkins 控制器

2.1 安装 Java 运行环境

Jenkins 对 Java 版本有明确要求,版本不匹配会导致服务无法启动。

Jenkins 版本

支持的 Java 版本

2.357 及以上

Java 11 或 Java 17

2.463 及以上

Java 17 或 Java 21

代码语言:bash
复制
apt update
apt install -y fontconfig openjdk-17-jre

java -version

🔴 版本必读: 安装 Jenkins 前先确认 Java 版本,装错版本时服务启动失败的报错指向类加载异常,很难直接判断是版本问题。先装 Java 再装 Jenkins,顺序不要颠倒。

2.2 添加仓库并安装

代码语言:bash
复制
curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key \
  | tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null

echo "deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/" \
  > /etc/apt/sources.list.d/jenkins.list

apt update
apt install -y jenkins

systemctl enable jenkins
systemctl start jenkins
systemctl status jenkins

2.3 获取初始密码并完成向导

代码语言:bash
复制
cat /var/lib/jenkins/secrets/initialAdminPassword

浏览器访问 http://你的实例公网IP:8080,输入上面的密码,选择安装推荐插件,创建管理员账号。

🔴 安全警示: 8080 端口直接暴露到公网存在风险。完成初始化后应改为用 Nginx 反向代理并配置 HTTPS,在控制台防火墙中关闭 8080 的公网放行,只保留 443。Jenkins 的凭据库中存有代码仓库密钥与部署密钥,被入侵的影响范围远超一台服务器。

2.4 配置反向代理

代码语言:nginx
复制
server {
    listen 443 ssl;
    server_name jenkins.your-domain.com;

    ssl_certificate     /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 300s;
    }
}

同时修改 Jenkins 监听地址为本地:

代码语言:bash
复制
# /etc/default/jenkins 或 systemd 覆盖文件中
JENKINS_LISTEN_ADDRESS=127.0.0.1

配置反向代理后,需在 Jenkins 的系统设置中把 Jenkins URL 改为 HTTPS 域名,否则构建通知中的链接会是错误地址。

三、挂接独立构建节点

3.1 在节点机上准备环境

在另一台实例上安装 Java 与构建工具:

代码语言:bash
复制
apt update
apt install -y openjdk-17-jre git

# 创建专用用户,不要用 root 跑构建
useradd -m -s /bin/bash jenkins
mkdir -p /home/jenkins/agent && chown jenkins:jenkins /home/jenkins/agent

⚠️ 权限注意: 用 root 运行构建任务意味着任何一个项目的构建脚本都拥有整机权限。创建专用用户并限制其权限范围,是构建节点的基础安全配置。

3.2 在控制器上添加节点

在 Jenkins 的节点管理中新建节点,关键配置:

配置项

建议值

说明

远程工作目录

/home/jenkins/agent

构建产物存放位置

标签

build-linux

用于任务指定运行节点

启动方式

通过 SSH 启动代理

控制器主动连接节点

主机地址

节点的内网 IP

走内网不消耗公网流量

节点凭据使用 SSH 密钥而非密码,在 Jenkins 凭据管理中添加私钥。

3.3 验证节点在线

节点状态显示为在线后,新建一个测试任务并在"限制项目的运行节点"中填入标签 build-linux,执行后在构建日志开头可看到运行节点名称。

四、用 Jenkinsfile 定义流水线

声明式流水线把构建过程写进代码仓库,比在界面上配置任务更易维护和追溯。

在项目根目录创建 Jenkinsfile:

代码语言:groovy
复制
pipeline {
    agent { label 'build-linux' }

    options {
        timeout(time: 30, unit: 'MINUTES')
        buildDiscarder(logRotator(numToKeepStr: '20'))
    }

    environment {
        DEPLOY_KEY = credentials('deploy-ssh-key')
    }

    stages {
        stage('检出代码') {
            steps {
                checkout scm
            }
        }

        stage('安装依赖') {
            steps {
                sh 'npm ci'
            }
        }

        stage('构建') {
            steps {
                sh 'npm run build'
            }
        }

        stage('部署') {
            when { branch 'main' }
            steps {
                sh '''
                    rsync -az --delete ./dist/ \
                      -e "ssh -i $DEPLOY_KEY -o StrictHostKeyChecking=no" \
                      deploy@目标服务器内网IP:/var/www/html/
                '''
            }
        }
    }

    post {
        always {
            cleanWs()
        }
        failure {
            echo '构建失败,请检查构建日志'
        }
    }
}

几个关键配置项的作用:

配置

作用

agent { label }

指定任务在哪个节点运行

timeout

防止卡住的任务无限占用节点

buildDiscarder

只保留最近 20 次构建记录,控制磁盘

credentials()

从凭据库注入密钥,不在代码中硬编码

when { branch }

只有主分支才执行部署

cleanWs()

构建结束清理工作区

🔴 凭据管理: 密钥必须通过 credentials() 从 Jenkins 凭据库注入,不要写进 Jenkinsfile。Jenkinsfile 在代码仓库中,任何有仓库读权限的人都能看到其中内容。

五、控制磁盘增长

Jenkins 磁盘被写满是最常见的运行故障,来源有三处:构建历史、工作区、Docker 镜像缓存。

来源

控制方式

构建历史与日志

在任务配置中设置 buildDiscarder 保留策略

工作区文件

在 post 中执行 cleanWs()

Docker 镜像与缓存

定期执行 docker system prune

全局保留策略可在系统配置中统一设定,避免逐个任务配置遗漏。

查看磁盘占用分布:

代码语言:bash
复制
du -sh /var/lib/jenkins/* | sort -rh | head -10

💡 运维建议: 把 docker system prune -af --filter "until=168h" 配成每周定时任务,清理一周前的无用镜像。容器化构建的节点如果不做清理,磁盘增长速度往往超出预期。

六、常见故障定位

现象

可能原因

处理方向

服务启动失败

Java 版本不匹配

核对版本对照表重装 Java

界面可访问但构建全部排队

无可用执行器或节点离线

检查节点状态与执行器数量

节点连接失败

SSH 密钥配置错误或内网不通

在控制器上手动 SSH 验证连通性

构建中途被终止

内存不足触发进程终止

提升节点规格或降低并发构建数

构建通知链接地址错误

Jenkins URL 未改为域名

在系统设置中修正 Jenkins URL

磁盘持续增长

未配置构建保留策略

设置全局 buildDiscarder 并清理工作区

七、部署完成后的检查项

检查一:8080 端口是否已关闭公网放行。 反向代理配置完成后,控制台防火墙中只保留 443,不保留 8080。

检查二:构建是否以非 root 用户运行。 在构建任务中执行 whoami 确认,返回 root 说明权限隔离未生效。

检查三:凭据是否已从代码中剥离。 检查 Jenkinsfile 与构建脚本中是否有明文密钥,有则迁移到凭据库并轮换。

检查四:快照是否已创建。 轻量应用服务器支持对实例创建快照,保存某个时间点的完整数据。

⚠️ 升级提醒: Jenkins 插件升级后出现兼容问题是常见情况,且插件降级往往不能完全恢复。升级插件前先创建快照,比事后逐个排查插件冲突省时得多。

总结

Jenkins 部署的核心是把控制器与构建节点分开:控制器 2 核 4 GB 负责调度与界面,构建节点 4 核 8 GB 承担编译打包,两者通过内网互联通信。安装前先确认 Java 版本,部署后用反向代理关闭 8080 的公网暴露。流水线用 Jenkinsfile 管理并通过凭据库注入密钥,同时配置构建保留策略与工作区清理控制磁盘增长。

轻量应用服务器以套餐形式交付计算、SSD 云硬盘与网络资源,提供快照备份、自定义镜像、内网互联与可视化防火墙配置,适合作为 Jenkins 控制器与构建节点的承载主机。套餐规格可在产品页查看:https://cloud.tencent.com/product/lighthouse

腾讯云双十一大促期间,轻量应用服务器多个规格参与促销,并提供代金券礼包、买赠时长与双人拼团加赠资源等优惠形式,适合搭建持续集成环境时一次性锁定多台实例成本。活动页面:https://cloud.tencent.com/act/pro/double11-202611

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 一、Jenkins 部署需要什么配置
  • 二、安装 Jenkins 控制器
    • 2.1 安装 Java 运行环境
    • 2.2 添加仓库并安装
    • 2.3 获取初始密码并完成向导
    • 2.4 配置反向代理
  • 三、挂接独立构建节点
    • 3.1 在节点机上准备环境
    • 3.2 在控制器上添加节点
    • 3.3 验证节点在线
  • 四、用 Jenkinsfile 定义流水线
  • 五、控制磁盘增长
  • 六、常见故障定位
  • 七、部署完成后的检查项
  • 总结
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档