debian上jenkins怎么用

下面按**“在 Debian 上安装 → 基本使用 → 常见场景”**给你一个完整、实用的入门指南。

一、在 Debian 上安装 Jenkins

1. 安装 Java（Jenkins 依赖）

Jenkins 需要 Java 11 或 Java 17（推荐 17）

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

验证：

java -version

2. 添加 Jenkins 官方源

sudo apt install -y wget gnupg
wget -O /usr/share/keyrings/jenkins-keyring.asc \
  https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key

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

3. 安装 Jenkins

sudo apt install -y jenkins

4. 启动并设置开机自启

sudo systemctl enable --now jenkins
sudo systemctl status jenkins

5. 开放端口（默认 8080）

sudo ufw allow 8080

浏览器访问：

http://<服务器IP>:8080

二、首次配置 Jenkins

1. 获取初始管理员密码

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

粘贴到网页中。

2. 安装推荐插件

选择 “Install suggested plugins”

3. 创建管理员账号

设置用户名、密码、邮箱。

三、Jenkins 基本使用

1. 创建一个 Freestyle 项目

首页 → New Item
输入名称 → 选择 Freestyle project
点击 OK

2. 配置 Git 拉代码

Source Code Management → Git
Repository URL：
```
https://github.com/xxx/xxx.git
```
Credentials：添加账号或 SSH Key

3. 配置构建步骤（示例）

构建 Shell 命令

echo "Build start"
npm install
npm run build

或 Java：

mvn clean package

4. 保存并构建

点击 Build Now
在 Console Output 查看日志。

四、Jenkins 常用目录（Debian）

内容	路径
主目录	`/var/lib/jenkins`
配置文件	`/etc/default/jenkins`
日志	`/var/log/jenkins/jenkins.log`
服务	`systemctl status jenkins`

五、常见实用场景

✅ 1. 定时构建（CI）

在 Build Triggers

H/30 * * * *

每 30 分钟一次

✅ 2. 远程触发构建

curl -X POST \
  http://admin:token@localhost:8080/job/test/build

✅ 3. 使用 Pipeline（推荐）

新建 Pipeline 项目：

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                sh 'make'
            }
        }
    }
}

六、常见问题

❌ 端口冲突

修改：

sudo nano /etc/default/jenkins

改 JENKINS_PORT=8081

重启：

sudo systemctl restart jenkins

❌ 权限问题

不要直接用 root 跑 Jenkins
使用 jenkins 用户：

sudo -u jenkins bash

如果你愿意，可以告诉我：

✅ 你是 前端 / Java / Python / Go？
✅ 想要 自动部署 / 打包 / 测试？
✅ 是否配合 Docker / Nginx / GitLab？

我可以直接给你一套 可用的 Jenkins 配置示例。