Linux下Jenkins怎样配置

一、Linux下Jenkins安装准备

1. 系统要求：确保Linux系统为Ubuntu、CentOS等主流发行版；内存≥256MB，磁盘≥1GB（建议SSD提升构建速度）。
2. Java环境：Jenkins依赖Java运行，需安装JDK 8或11（推荐OpenJDK）。可通过java -version验证，未安装则执行：
   • Ubuntu/Debian：sudo apt update && sudo apt install openjdk-11-jdk
   • CentOS/Fedora：sudo yum install java-11-openjdk-devel。

二、Jenkins安装步骤

1. 添加官方仓库（Ubuntu/Debian为例）：
   • 导入GPG密钥：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。
2. 安装Jenkins：执行sudo apt install jenkins（CentOS/Fedora替换为sudo yum install jenkins），安装过程中确认依赖项安装。
3. 启动与开机自启：
   • 启动服务：sudo systemctl start jenkins
   • 设置开机自启：sudo systemctl enable jenkins
   • 检查状态：sudo systemctl status jenkins（显示“active (running)”即为成功）。

三、初始配置

1. 获取初始密码：首次访问需输入管理员密码，执行sudo cat /var/lib/jenkins/secrets/initialAdminPassword复制密码。
2. 完成向导：
   • 访问http://<服务器IP>:8080，粘贴密码进入向导。
   • 安装插件：推荐选择“安装建议的插件”（包含Git、Maven、Pipeline等常用插件）；若网络慢，可进入“Manage Jenkins→Manage Plugins→Advanced”，修改Update Site为国内镜像（如http://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json）。
   • 创建管理员用户：填写用户名、密码、邮箱等信息，点击“保存并完成”。
3. 配置全局工具（关键步骤）：
   • 进入“Manage Jenkins→Global Tool Configuration”：
     • JDK：添加JDK路径（若已安装，Jenkins会自动检测；否则手动指定JAVA_HOME，如/usr/lib/jvm/java-11-openjdk-amd64）。
     • Git：配置Git可执行文件路径（若已安装，Jenkins会自动检测；否则手动指定/usr/bin/git）。
     • Maven/Gradle（可选）：添加安装路径或选择自动安装。

四、常用配置优化

1. 修改端口/工作目录：
   • 编辑配置文件（Ubuntu/Debian为/etc/default/jenkins，CentOS为/etc/sysconfig/jenkins）：
     • 修改端口：JENKINS_PORT="8081"（避免与现有服务冲突）。
     • 修改工作目录：JENKINS_HOME="/var/lib/jenkins"（默认路径，可自定义，需确保权限正确）。
   • 重启服务生效：sudo systemctl restart jenkins。
2. 配置HTTPS（生产环境必选）：
   • 生成SSL证书（可使用Let’s Encrypt免费证书）：sudo certbot certonly --standalone -d yourdomain.com
   • 启动时指定证书路径：java -jar jenkins.war --httpsPort=8443 --httpsKeyStore=/etc/letsencrypt/live/yourdomain.com/fullchain.pem --httpsKeyStorePassword=yourpassword
   • 或通过系统服务配置（修改JENKINS_OPTS参数）。
3. 调整JVM内存：
   • 编辑配置文件（同上），添加JAVA_OPTS="-Xms512m -Xmx2048m -Djava.awt.headless=true"（初始堆内存512MB，最大堆内存2048MB，无头模式运行）。

五、安全配置

1. 限制监听地址：修改配置文件，设置JENKINS_LISTEN_ADDRESS="127.0.0.1"（仅本地访问）或内网IP（如192.168.1.100），避免暴露在公网。
2. 禁用CSRF保护（测试环境可选）：启动时添加--disable-hudson.security.csrf.CrumbIssuer参数，生产环境建议保持开启。
3. 定期更新：通过“Manage Jenkins→Manage Plugins→Available”检查插件更新，及时升级Jenkins核心及插件（避免安全漏洞）。

六、常见问题解决

1. 端口冲突：执行netstat -tulpn | grep 8080查看端口占用，修改Jenkins端口或停止占用服务。
2. 插件安装慢：更换国内镜像源（如清华镜像），修改/var/lib/jenkins/updates/default.json（替换updates.jenkins.io为mirrors.tuna.tsinghua.edu.cn/jenkins）。
3. 权限问题：确保JENKINS_HOME目录权限正确（chown -R jenkins:jenkins /var/lib/jenkins，jenkins为用户）。