Jenkins于Linux怎样部署

Linux 部署 Jenkins 实操指南

一 环境准备

• 确认系统为常见发行版（如 Ubuntu/Debian/CentOS/Fedora），并具备 sudo 权限。
• 安装 Java 8 或 11（Jenkins 长期支持版本对 Java 8/11 兼容良好）：
  • Ubuntu/Debian

    sudo apt update
    sudo apt install openjdk-11-jdk -y
    

  • CentOS/Fedora

    sudo yum install java-11-openjdk-devel -y    # CentOS/RHEL
    # 或
    sudo dnf install java-11-openjdk-devel -y    # Fedora
    

• 验证版本：java -version，输出应显示 1.8 或 11。

二 安装方式

• 方式 A 包管理器安装（推荐）
  • Ubuntu/Debian

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

  • CentOS/RHEL/Fedora

    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 -y    # 或 dnf install jenkins -y
    sudo systemctl daemon-reload
    sudo systemctl start jenkins
    sudo systemctl enable jenkins
    sudo systemctl status jenkins
    

• 方式 B 直接运行 WAR 包
  • 准备目录与变量

    mkdir -p /opt/jenkins && cd /opt/jenkins
    echo 'JENKINS_HOME=/opt/jenkins' | sudo tee -a /etc/profile
    source /etc/profile
    

  • 下载并启动（示例为稳定分支 WAR）

    wget https://get.jenkins.io/war-stable/latest/jenkins.war
    nohup java -Xmx2g -jar jenkins.war --httpPort=8080 > logs/jenkins.log 2>&1 &
    tail -f logs/jenkins.log
    

  • 说明：WAR 方式便于快速试用与迁移，生产环境建议使用包管理器或容器化部署。

三 访问与安全配置

• 防火墙放行
  • Ubuntu/Debian（UFW）

    sudo ufw allow 8080/tcp
    sudo ufw enable
    

  • CentOS/RHEL/Fedora（firewalld）

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

• 首次访问与解锁
  • 浏览器访问：http://<服务器IP>:8080
  • 获取初始管理员密码
    • 包管理器安装：sudo cat /var/lib/jenkins/secrets/initialAdminPassword
    • WAR 安装：cat $JENKINS_HOME/secrets/initialAdminPassword
  • 完成安装向导后，建议立即修改管理员密码并配置安全策略（如仅限内网访问、启用 CSRF 保护等）。

四 反向代理与域名访问（可选）

• Nginx 示例

  sudo apt install nginx -y    # 或 yum/dnf 安装
  

  编辑站点配置（如 /etc/nginx/sites-available/default）：

  server {
      listen 80;
      server_name jenkins.example.com;
  
      location / {
          proxy_pass http://127.0.0.1:8080;
          proxy_set_header Host $host;
          proxy_set_header X-Real-IP $remote_addr;
          proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
          proxy_set_header X-Forwarded-Proto $scheme;
      }
  }
  

  启用站点并重启：

  sudo ln -s /etc/nginx/sites-available/default /etc/nginx/sites-enabled/
  sudo nginx -t && sudo systemctl reload nginx
  

• Apache 亦可类似配置，使用 mod_proxy 与 mod_proxy_http 进行反向代理。

五 常用目录与维护要点

• 关键路径（RPM/系统服务常见）
  • 安装目录：/usr/share/jenkins/
  • 配置文件：/etc/sysconfig/jenkins（可修改 JENKINS_PORT 等）
  • 数据目录：/var/lib/jenkins/（含 secrets/initialAdminPassword）
  • 日志文件：/var/log/jenkins/jenkins.log
• 常用命令

  sudo systemctl restart jenkins
  sudo systemctl stop jenkins
  sudo systemctl status jenkins
  

• 升级与迁移
  • 包管理器升级：sudo apt upgrade jenkins 或 sudo yum/dnf update jenkins
  • WAR 包升级：替换 $JENKINS_HOME/war 或程序目录中的 jenkins.war 后重启
  • 迁移：整体拷贝 $JENKINS_HOME 到新机器，保持目录权限一致后启动服务。