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），或在网络稳定时重试。

0 赞

0 踩