Debian下Jenkins怎么使用

在 Debian 下使用 Jenkins，一般分为 安装 → 初始化 → 常用配置 → 创建任务 → 常见使用场景。下面给你一份从零到可用的实用指南。

一、在 Debian 上安装 Jenkins

1️⃣ 安装 Java（Jenkins 依赖）

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

验证：

java -version

2️⃣ 添加 Jenkins 官方源（推荐）

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

3️⃣ 安装 Jenkins

sudo apt update
sudo apt install -y jenkins

4️⃣ 启动并设置开机自启

sudo systemctl enable jenkins
sudo systemctl start jenkins

查看状态：

sudo systemctl status jenkins

二、初始化 Jenkins

1️⃣ 访问 Jenkins

浏览器访问：

http://服务器IP:8080

2️⃣ 获取初始管理员密码

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

复制并粘贴到网页中。

3️⃣ 安装插件

推荐选择： ✅ Install suggested plugins

常用插件：

Git
Pipeline
Docker
SSH
Blue Ocean（可选）

4️⃣ 创建管理员用户

设置用户名 / 密码 / 邮箱

三、Jenkins 目录结构（Debian）

目录	说明
`/var/lib/jenkins`	Jenkins 主目录
`/var/lib/jenkins/jobs`	任务配置
`/var/lib/jenkins/workspace`	构建工作空间
`/etc/default/jenkins`	启动参数
`/var/log/jenkins/jenkins.log`	日志

四、创建第一个 Jenkins 任务（示例）

示例 1：Freestyle 项目（最简单）

New Item
输入任务名 → 选择 Freestyle project
Source Code Management
- 选 Git
- Repository URL：
```
https://github.com/your/repo.git
```
Build Steps
- Add build step → Execute shell
```
echo "Hello Jenkins"
git --version
```
保存 → Build Now

示例 2：Pipeline（推荐方式）

1️⃣ 新建 Pipeline 项目

2️⃣ Pipeline 脚本示例

pipeline {
    agent any

    stages {
        stage('拉取代码') {
            steps {
                git 'https://github.com/your/repo.git'
            }
        }

        stage('构建') {
            steps {
                sh 'make'
            }
        }

        stage('测试') {
            steps {
                sh 'make test'
            }
        }
    }
}

五、Jenkins + Git + Debian 常见用法

✅ 自动触发构建（Git Webhook）

Jenkins 设置：

任务配置 → Build Triggers
✅ GitHub hook trigger / Poll SCM

Git 仓库：

Webhook URL：

http://jenkins_ip:8080/github-webhook/

六、Jenkins 使用 Docker（非常常见）

安装 Docker

sudo apt install -y docker.io
sudo usermod -aG docker jenkins
sudo systemctl restart jenkins

Pipeline 示例（Docker 构建）

pipeline {
    agent any

    stages {
        stage('Docker Build') {
            steps {
                sh 'docker build -t myapp .'
            }
        }
    }
}

七、常见问题排查

1️⃣ 端口被占用

sudo nano /etc/default/jenkins

修改：

HTTP_PORT=8081

重启：

sudo systemctl restart jenkins

2️⃣ 权限问题

sudo chown -R jenkins:jenkins /var/lib/jenkins

3️⃣ Jenkins 无法访问

sudo ufw allow 8080

八、Debian 下 Jenkins 常见使用场景

✅ 自动编译 C / C++ / Java / Go
✅ CI/CD（Git → 构建 → 测试 → 部署）
✅ Docker 镜像自动构建
✅ 自动部署到服务器
✅ 定时任务（cron）

九、下一步你可以做什么？

你可以告诉我：

✅ 你是用来做什么的？（开发 / 运维 / 自动部署）
✅ 是否使用 Docker？
✅ 是否配合 Git + Shell？
✅ 是否是服务器环境？

我可以直接给你 可用的 Jenkinsfile 或完整 CI/CD 方案。