Jenkins Linux安装步骤是什么

Linux 安装 Jenkins 步骤

一 准备环境

• 安装 Java 11 或 Java 17（LTS），推荐 OpenJDK。
  • Ubuntu/Debian：sudo apt update && sudo apt install openjdk-11-jdk
  • CentOS/RHEL：sudo yum install java-11-openjdk-devel
• 验证：java -version 应显示 11 或 17。

二 安装方式

• 方式 A RPM/DEB 包（推荐，便于 systemd 管理）

  • 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 jenkins
      • sudo systemctl start jenkins && sudo systemctl enable jenkins
  • Debian/Ubuntu：
    • 添加密钥与源（使用 APT 密钥环）：
      • 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 update && sudo apt install jenkins
      • sudo systemctl start jenkins && sudo systemctl enable jenkins

• 方式 B 通用 WAR 包（适合容器或无外网环境）

  • 准备 Java（同上），下载并运行：
    • wget https://get.jenkins.io/war-stable/latest/jenkins.war
    • java -jar jenkins.war –httpPort=8080
  • 后台运行：
    • nohup java -jar jenkins.war –httpPort=8080 > /var/log/jenkins.log 2>&1 &

三 防火墙与访问

• 开放端口（默认 8080）：
  • firewalld：sudo firewall-cmd –permanent –add-port=8080/tcp && sudo firewall-cmd –reload
  • ufw：sudo ufw allow 8080
• 访问：浏览器打开 http://<服务器IP>:8080。

四 初始化配置

• 解锁：查看初始管理员密码
  • 系统服务安装：sudo cat /var/lib/jenkins/secrets/initialAdminPassword
  • WAR 运行：cat /var/lib/jenkins/secrets/initialAdminPassword（若工作目录为 /var/lib/jenkins）
• 插件与账户：
  • 选择 Install suggested plugins 或 Skip plugin installation（离线预先准备插件时）
  • 创建管理员用户，完成设置。

五 常见问题与排错

• 端口冲突：修改端口后重启
  • 编辑配置文件：/etc/default/jenkins（Debian/Ubuntu）或 /etc/sysconfig/jenkins（RHEL/CentOS），将 JENKINS_PORT=8080 改为如 9090
  • 重启：sudo systemctl restart jenkins
  • WAR 方式：java -jar jenkins.war –httpPort=9090
• 查看日志：
  • systemd：sudo journalctl -u jenkins -f
  • WAR：tail -f /var/log/jenkins.log
• 插件镜像加速（国内环境）：
  • 进入 Manage Jenkins > Manage Plugins > Advanced，将 Update Site URL 改为：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
• 离线环境插件：
  • 使用 jenkins-plugin-manager 预先下载插件及依赖，拷贝到 /var/lib/jenkins/plugins 后重启。