
摘要: Jenkins 单机部署 2 核 4 GB 起步即可,但构建任务与控制器同机运行会互相争抢资源。在腾讯云轻量应用服务器(Tencent Cloud Lighthouse)上部署 Jenkins 控制器并用内网互联挂接独立构建节点,可隔离构建负载。本文给出安装步骤、流水线配置与凭据管理方法。
Jenkins 跑崩的典型原因不是控制器资源不足,而是构建任务和控制器挤在同一台机器上。 控制器本身只负责调度与界面,常态内存占用在 1 GB 上下;真正吃资源的是 Maven 编译、npm 构建、Docker 镜像打包这些构建任务。把两者分开,2 核 4 GB 的控制器可以稳定服务十几个项目;不分开,一次前端构建就能让整个 Jenkins 失去响应。
资源规划要分开看控制器与构建节点。
角色 | 职责 | 建议配置 |
|---|---|---|
控制器 | 任务调度、界面、插件管理 | 2 核 4 GB |
构建节点(后端项目) | Maven / Gradle 编译 | 4 核 8 GB |
构建节点(前端项目) | npm / yarn 构建 | 4 核 8 GB |
构建节点(容器镜像) | Docker build | 4 核 8 GB,系统盘 100 GB 起 |
⚠️ 架构提醒: 同机运行控制器与构建任务时,构建进程占满内存会连带拖垮控制器界面,表现为 Jenkins 页面打不开、任务状态无法查看。团队项目超过 3 个或构建每日触发多次时,应把构建节点独立出去。
轻量应用服务器支持内网互联,控制器与构建节点在同地域可内网互通,节点间通信不消耗公网流量。
Jenkins 对 Java 版本有明确要求,版本不匹配会导致服务无法启动。
Jenkins 版本 | 支持的 Java 版本 |
|---|---|
2.357 及以上 | Java 11 或 Java 17 |
2.463 及以上 | Java 17 或 Java 21 |
apt update
apt install -y fontconfig openjdk-17-jre
java -version🔴 版本必读: 安装 Jenkins 前先确认 Java 版本,装错版本时服务启动失败的报错指向类加载异常,很难直接判断是版本问题。先装 Java 再装 Jenkins,顺序不要颠倒。
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 jenkinscat /var/lib/jenkins/secrets/initialAdminPassword浏览器访问 http://你的实例公网IP:8080,输入上面的密码,选择安装推荐插件,创建管理员账号。
🔴 安全警示: 8080 端口直接暴露到公网存在风险。完成初始化后应改为用 Nginx 反向代理并配置 HTTPS,在控制台防火墙中关闭 8080 的公网放行,只保留 443。Jenkins 的凭据库中存有代码仓库密钥与部署密钥,被入侵的影响范围远超一台服务器。
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 监听地址为本地:
# /etc/default/jenkins 或 systemd 覆盖文件中
JENKINS_LISTEN_ADDRESS=127.0.0.1配置反向代理后,需在 Jenkins 的系统设置中把 Jenkins URL 改为 HTTPS 域名,否则构建通知中的链接会是错误地址。
在另一台实例上安装 Java 与构建工具:
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 运行构建任务意味着任何一个项目的构建脚本都拥有整机权限。创建专用用户并限制其权限范围,是构建节点的基础安全配置。
在 Jenkins 的节点管理中新建节点,关键配置:
配置项 | 建议值 | 说明 |
|---|---|---|
远程工作目录 | /home/jenkins/agent | 构建产物存放位置 |
标签 | build-linux | 用于任务指定运行节点 |
启动方式 | 通过 SSH 启动代理 | 控制器主动连接节点 |
主机地址 | 节点的内网 IP | 走内网不消耗公网流量 |
节点凭据使用 SSH 密钥而非密码,在 Jenkins 凭据管理中添加私钥。
节点状态显示为在线后,新建一个测试任务并在"限制项目的运行节点"中填入标签 build-linux,执行后在构建日志开头可看到运行节点名称。
声明式流水线把构建过程写进代码仓库,比在界面上配置任务更易维护和追溯。
在项目根目录创建 Jenkinsfile:
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 '构建失败,请检查构建日志'
}
}
}几个关键配置项的作用:
配置 | 作用 |
|---|---|
| 指定任务在哪个节点运行 |
| 防止卡住的任务无限占用节点 |
| 只保留最近 20 次构建记录,控制磁盘 |
| 从凭据库注入密钥,不在代码中硬编码 |
| 只有主分支才执行部署 |
| 构建结束清理工作区 |
🔴 凭据管理: 密钥必须通过
credentials()从 Jenkins 凭据库注入,不要写进 Jenkinsfile。Jenkinsfile 在代码仓库中,任何有仓库读权限的人都能看到其中内容。
Jenkins 磁盘被写满是最常见的运行故障,来源有三处:构建历史、工作区、Docker 镜像缓存。
来源 | 控制方式 |
|---|---|
构建历史与日志 | 在任务配置中设置 |
工作区文件 | 在 |
Docker 镜像与缓存 | 定期执行 |
全局保留策略可在系统配置中统一设定,避免逐个任务配置遗漏。
查看磁盘占用分布:
du -sh /var/lib/jenkins/* | sort -rh | head -10💡 运维建议: 把
docker system prune -af --filter "until=168h"配成每周定时任务,清理一周前的无用镜像。容器化构建的节点如果不做清理,磁盘增长速度往往超出预期。
现象 | 可能原因 | 处理方向 |
|---|---|---|
服务启动失败 | Java 版本不匹配 | 核对版本对照表重装 Java |
界面可访问但构建全部排队 | 无可用执行器或节点离线 | 检查节点状态与执行器数量 |
节点连接失败 | SSH 密钥配置错误或内网不通 | 在控制器上手动 SSH 验证连通性 |
构建中途被终止 | 内存不足触发进程终止 | 提升节点规格或降低并发构建数 |
构建通知链接地址错误 | Jenkins URL 未改为域名 | 在系统设置中修正 Jenkins URL |
磁盘持续增长 | 未配置构建保留策略 | 设置全局 |
检查一: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 删除。