jenkins在centos的部署教程

在 CentOS 上部署 Jenkins 的完整教程

一 环境准备与 Java 安装

• 更新系统并安装常用工具：
  • 命令：sudo yum update -y && sudo yum install -y wget vim
• 安装 Java（推荐 OpenJDK 11；如需 Java 17，见文末补充）：
  • 命令：sudo yum install -y java-11-openjdk-devel
  • 验证：java -version 应显示 11.x
• 说明：Jenkins 2.414.x 等 LTS 版本要求 Java 11 或更高版本，生产环境优先选择 OpenJDK 11/17。

二 安装与启动 Jenkins（RPM 方式）

• 添加 Jenkins 官方仓库并导入 GPG 密钥：
  • 命令：

    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
    

• 安装 Jenkins：
  • 命令：sudo yum install -y jenkins
• 启动并设置开机自启：
  • 命令：

    sudo systemctl daemon-reload
    sudo systemctl start jenkins
    sudo systemctl enable jenkins
    

• 验证服务状态：
  • 命令：sudo systemctl status jenkins（应显示 active (running)）

三 防火墙与访问初始化

• 开放 8080 端口（firewalld）：
  • 命令：

    sudo firewall-cmd --permanent --add-port=8080/tcp
    sudo firewall-cmd --reload
    

• 访问 Jenkins Web 界面：http://<服务器IP>:8080
• 解锁 Jenkins：
  • 获取初始管理员密码：sudo cat /var/lib/jenkins/secrets/initialAdminPassword
  • 在向导中输入密码，选择安装推荐插件，随后创建管理员账户并完成初始化。

四 基础配置与第一个任务

• 安装常用工具（用于拉取代码与构建）：
  • 命令：sudo yum install -y git maven
• 在 Jenkins 中创建 Freestyle 任务：
  • 源码管理：选择 Git，填写仓库 URL 与分支（如 main）
  • 构建触发器：可选 轮询 SCM 或配置 Webhook
  • 构建步骤：执行 Maven 命令（如 mvn clean package）
• 保存并运行构建，查看控制台输出确认成功。

五 可选方案与常见问题

• Docker 快速部署（适合快速试用或隔离环境）：
  • 拉取镜像：docker pull jenkins/jenkins:lts
  • 启动容器（持久化数据到 /var/jenkins_home）：

    mkdir -p /var/jenkins_home
    sudo chown -R 1000:1000 /var/jenkins_home
    docker run -d --name jenkins -p 8080:8080 -v /var/jenkins_home:/var/jenkins_home jenkins/jenkins:lts
    

  • 初始密码路径（容器内）：/var/jenkins_home/secrets/initialAdminPassword
• 常见问题与优化要点：
  • 端口被占用：编辑 /etc/sysconfig/jenkins，修改 JENKINS_PORT 后重启服务
  • 权限问题：确保 /var/lib/jenkins 等目录属主为 jenkins:jenkins
  • 插件安装慢：在插件管理配置国内镜像源以加速
  • 性能优化：合理设置 JVM 堆大小、限制并发构建、定期清理旧构建与历史数据
• Java 17 补充（如希望使用 Oracle JDK 17）：
  • 下载并安装：

    wget https://download.oracle.com/java/17/latest/jdk-17_linux-x64_bin.rpm
    sudo yum install -y ./jdk-17_linux-x64_bin.rpm
    java -version  # 应显示 17.x