Jenkins在Ubuntu上的部署教程

在 Ubuntu 上部署 Jenkins 的完整教程

一 环境准备与安装

• 更新系统并安装 Java 11（Jenkins 2.x 建议使用 OpenJDK 11）：

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

• 导入 Jenkins 官方仓库 GPG 密钥（使用 APT 密钥环方式更安全）：

  curl -fsSL https://pkg.jenkins.io/debian/jenkins.io.key | sudo tee \
    /usr/share/keyrings/jenkins-keyring.asc >
       /dev/null
  

• 添加 Jenkins 软件源（Debian 稳定版）：

  echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] \
    https://pkg.jenkins.io/debian binary/ | sudo tee \
    /etc/apt/sources.list.d/jenkins.list >
       /dev/null
  

• 安装并启动 Jenkins：

  sudo apt update
  sudo apt install jenkins -y
  sudo systemctl start jenkins
  sudo systemctl enable jenkins
  sudo systemctl status jenkins
  

以上步骤完成后，Jenkins 会以系统服务方式运行，默认监听 8080 端口。

二 初始化与安全配置

• 访问 http://< 服务器IP> :8080，进入解锁页面，获取初始管理员密码：

  sudo cat /var/lib/jenkins/secrets/initialAdminPassword
  

• 在向导中选择 Install suggested plugins 安装推荐插件，随后创建 管理员账户 完成初始化。
• 如需修改默认端口（例如改为 8088）：
  • 编辑服务文件（不同系统路径可能不同，常见为 /lib/systemd/system/jenkins.service 或 /usr/lib/systemd/system/jenkins.service）：

    sudo systemctl edit --full jenkins
    # 或
    sudo vim /lib/systemd/system/jenkins.service
    

  • 找到 Environment=“JENKINS_PORT=8080”，改为 8088，保存后执行：

    sudo systemctl daemon-reload
    sudo systemctl restart jenkins
    

• 防火墙放行（如使用 UFW）：

  sudo ufw allow 8080/tcp
  sudo ufw reload
  

完成以上步骤后，可通过 http://< 服务器IP> :8088 访问 Jenkins。

三 基础 CI 配置与第一个任务

• 安装常用插件（Manage Jenkins → Manage Plugins）：
  • Git plugin：拉取代码
  • Pipeline plugin：定义流水线
• 创建 Pipeline Job：
  • 新建任务 → 选择 Pipeline → 在 Pipeline 部分可选择：
    • Pipeline script：直接编写 Jenkinsfile 脚本
    • Pipeline script from SCM：从 Git 仓库拉取并读取 Jenkinsfile
• 示例 Jenkinsfile（声明式流水线）：

  pipeline {
  
    agent any
    stages {
  
      stage('Build') {
  
        steps {
  
          sh 'echo "Build step"'
        }
  
      }
  
      stage('Test') {
  
        steps {
  
          sh 'echo "Test step"'
        }
  
      }
  
      stage('Deploy') {
  
        steps {
  
          sh 'echo "Deploy step"'
        }
  
      }
  
    }
  
  }
      
  

保存后点击 Build Now 执行，验证流水线运行。

四 常见问题与排查

• 端口被占用：检查并停止占用 8080 的进程，或按上文修改 JENKINS_PORT 后重载服务。
• 访问被拒绝或无法连接：确认云服务器安全组/本机防火墙已放行对应端口（如 8080/8088）。
• 服务未启动：使用 sudo systemctl status jenkins 查看日志与状态，必要时 journalctl -u jenkins -xe 排查。
• 插件安装缓慢或失败：更换为国内镜像源（Manage Jenkins → Manage Plugins → Advanced → Update Site），或在网络稳定时重试。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！