Jenkins Ubuntu部署注意什么

在 Ubuntu 上部署 Jenkins 时，有几个关键点需要注意，涵盖安装方式、权限、安全、流水线运行环境等方面。下面按实战经验总结：

一、安装方式选择

1. 推荐：使用官方 APT 源（稳定、易升级）

sudo apt update
sudo apt install openjdk-17-jdk -y
wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo apt-key add -
sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'
sudo apt update
sudo apt install jenkins -y

✅ 优点：

• 自动创建 jenkins 用户
• systemd 管理方便
• 升级简单

❌ 不推荐：

• 直接 java -jar jenkins.war（生产环境不友好）

二、Java 版本注意

• Jenkins 2.4xx+ 要求 Java 17+
• Ubuntu 22.04+ 推荐：

openjdk-17-jdk

• 多 Java 版本时明确指定：

sudo update-alternatives --config java

三、用户和权限问题（最容易踩坑）

1. Jenkins 默认用户

• 用户名：jenkins
• 家目录：/var/lib/jenkins

2. 权限常见坑

• 不能用 root 跑 Jenkins（有安全风险）
• 构建中要操作 Docker：

sudo usermod -aG docker jenkins
sudo systemctl restart jenkins

• 访问磁盘/目录无权限：

sudo chown -R jenkins:jenkins /your/build/path

四、端口与防火墙

默认端口

• 8080

修改端口

sudo nano /etc/default/jenkins

修改：

HTTP_PORT=8080

防火墙

sudo ufw allow 8080

⚠️ 生产环境建议：

• Nginx 反向代理
• 启用 HTTPS

五、生产环境安全建议

1. 不要直接暴露 8080

用 Nginx：

location / {
    proxy_pass http://localhost:8080;
}

2. 启用安全

• 首次启动解锁密码：

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

• 必须：
  • 启用用户认证
  • 安装 Role-based Authorization Strategy

3. 定期备份

重要目录：

/var/lib/jenkins

可用：

• Jenkins 内置备份插件
• rsync / cron

六、Ubuntu 版本兼容

七、构建环境注意

• 构建 Node / Python / Maven 时：
  • 尽量用 Jenkins Agent
  • 或 Docker 构建容器
• 避免污染宿主机环境

八、常见故障

九、总结一句话

Ubuntu 部署 Jenkins：用官方源、Java 17、jenkins 用户跑、Docker 权限给够、别裸奔 8080。

如果你需要：

• ✅ Jenkins + Docker 最佳配置
• ✅ Jenkinsfile 示例
• ✅ Nginx + HTTPS 配置

可以直接告诉我你的使用场景。