Linux里Jenkins如何管理

Linux下Jenkins管理实操指南

一 安装与初始化

• 准备环境：安装并验证 Java 11+（推荐 OpenJDK 11）。例如在 RHEL/CentOS 上执行：sudo yum install -y java-11-openjdk java-11-openjdk-devel；在 Debian/Ubuntu 上执行：sudo apt-get update && sudo apt-get install -y openjdk-11-jdk。完成后用 java -version 校验。
• 安装方式A（系统包管理器）：
  • RHEL/CentOS：导入仓库与密钥后安装并启动
    sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
    sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key
    sudo yum install -y jenkins
    sudo systemctl daemon-reload && sudo systemctl enable --now jenkins
  • Debian/Ubuntu：导入密钥与仓库后安装并启动
    curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo 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/ | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
    sudo apt-get update && sudo apt-get install -y jenkins
    sudo systemctl enable --now jenkins
• 安装方式B（WAR 运行）：nohup java -jar /usr/local/jenkins/jenkins.war --httpPort=8080 > logs/jenkins.log 2>&1 &
• 初始化：访问 http://服务器IP:8080，解锁管理员账户（查看初始密码：sudo cat /var/lib/jenkins/secrets/initialAdminPassword），选择“安装推荐插件”，创建管理员用户。

二 服务与端口管理

• systemd 常用命令：
  • 启动/停止/重启/状态：sudo systemctl start|stop|restart|status jenkins
  • 开机自启：sudo systemctl enable jenkins
• 端口与防火墙：
  • 修改端口（RHEL/CentOS）：编辑 /etc/sysconfig/jenkins，设置 JENKINS_PORT=“8081”，然后 sudo systemctl restart jenkins
  • 防火墙放行：
    • firewalld：sudo firewall-cmd --permanent --add-port=8080/tcp && sudo firewall-cmd --reload
    • ufw：sudo ufw allow 8080
• Web 端便捷操作：在已登录的 Jenkins 页面执行 /restart、/reload、/exit 进行重启、重载配置、退出。

三 目录与配置管理

• 关键目录与文件（RHEL/CentOS 常见路径，Debian/Ubuntu 多为 /etc/default/jenkins 等）：
  • 安装目录：/usr/lib/jenkins/jenkins.war
  • 配置：/etc/sysconfig/jenkins（JENKINS_HOME、JENKINS_PORT、JENKINS_USER、JENKINS_JAVA_OPTIONS 等）
  • 数据目录：/var/lib/jenkins（JENKINS_HOME，含 jobs、plugins、workspace 等）
  • 日志：/var/log/jenkins/jenkins.log
• 常用配置项：
  • 修改 JENKINS_HOME：在 /etc/sysconfig/jenkins 中设置 JENKINS_HOME=“/data/jenkins”，确保目录存在并赋权，然后重启
  • 调整 JVM：在 /etc/sysconfig/jenkins 设置 JENKINS_JAVA_OPTIONS=“-Xmx1024m -XX:MaxPermSize=512m”（数值按机器内存调整）
  • 修改运行用户：设置 JENKINS_USER=“jenkins”（不建议直接用 root，生产环境请遵循最小权限原则）
• 插件与更新源：
  • 镜像加速：编辑 /var/lib/jenkins/hudson.model.UpdateCenter.xml，将 URL 改为 https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
  • 也可在“Manage Jenkins → Manage Plugins → Advanced”中修改 Update Site

四 权限与安全加固

• 运行用户与目录权限：Jenkins 通常以 jenkins 用户运行，构建/部署目标目录需对 jenkins 可写；必要时使用 chown/chmod 调整，避免直接用 root 运行服务。
• Docker 权限：构建或部署需要 Docker 时，将 jenkins 加入 docker 组（sudo usermod -aG docker jenkins），并重启 Jenkins 使其生效。
• 认证与授权：启用基于角色的访问控制（RBAC）插件、外部认证（如 LDAP/SSO），并使用“凭证”插件安全存储密钥/密码。
• 网络安全：通过反向代理（Nginx/Apache）配置 HTTPS，仅暴露必要端口，限制管理端口访问来源。

五 备份恢复与升级

• 备份：定期备份 JENKINS_HOME（/var/lib/jenkins），例如：
  • 全量打包：tar czf jenkins-backup-$(date +%F).tar.gz -C /var/lib/jenkins .
  • 或 rsync：rsync -a /var/lib/jenkins/ /backup/jenkins/
• 恢复：停止服务，将备份解压/同步回 JENKINS_HOME，确认权限一致后启动服务。
• 升级：
  • 包管理安装：sudo yum update jenkins 或 sudo apt-get upgrade jenkins，升级后 systemctl restart jenkins
  • WAR 运行：替换 /usr/local/jenkins/jenkins.war 为新的稳定版 WAR，重启进程
• 回滚：保留上一版本 WAR 或系统包，出现异常可快速回退并恢复 JENKINS_HOME。