ubuntu下jenkins如何配置

下面按**“安装 → 基础配置 → 常用集成”**的顺序，给你一份在 Ubuntu 下配置 Jenkins 的实用指南（以 Ubuntu 20.04 / 22.04 为例）。

一、安装 Jenkins（Ubuntu）

1. 安装 Java（Jenkins 依赖）

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

Jenkins 2.4xx 推荐使用 Java 17

检查：

java -version

2. 添加 Jenkins 源并安装

sudo 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
sudo apt install -y jenkins

3. 启动 Jenkins

sudo systemctl start jenkins
sudo systemctl enable jenkins

查看状态：

sudo systemctl status jenkins

4. 开放端口（默认 8080）

sudo ufw allow 8080

浏览器访问：

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

二、初始配置

1. 获取管理员密码

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

粘贴到网页中。

2. 安装推荐插件

• 选择 “Install suggested plugins”
• 等待安装完成

3. 创建管理员用户

填写：

• 用户名
• 密码
• 邮箱

三、Jenkins 基础配置

1. 全局工具配置

路径：

Manage Jenkins → Global Tool Configuration

常见配置：

• JDK
  • 名称：JDK17
  • 路径：/usr/lib/jvm/java-17-openjdk-amd64
• Git
  • 默认已安装
• Maven / Gradle（按需）
• NodeJS（前端项目）

2. 系统配置（可选）

Manage Jenkins → System

• Jenkins URL
• 邮件通知（SMTP）
• 工作空间目录（默认 /var/lib/jenkins/workspace）

四、配置第一个流水线（Pipeline）

方式一：Freestyle 项目

1. 新建任务 → Freestyle project
2. 源码管理 → Git
3. 构建 → 执行 shell

echo "Hello Jenkins"

方式二：Jenkinsfile（推荐）

项目根目录添加 Jenkinsfile：

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                sh 'echo Building...'
            }
        }
    }
}

Jenkins 中：

• 新建任务 → Pipeline
• 选择 Pipeline script from SCM
• 填写 Git 地址

五、常见问题

1. 权限问题

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

2. Docker 集成

sudo usermod -aG docker jenkins
sudo systemctl restart jenkins

3. 忘记密码

sudo vim /var/lib/jenkins/config.xml
# 修改 <useSecurity>false</useSecurity>
sudo systemctl restart jenkins

六、生产建议

• 使用 Nginx + HTTPS
• 定期备份 /var/lib/jenkins
• 使用 Role-Based Authorization
• CI/CD 推荐使用 Pipeline + Webhook

如果你有具体需求（比如：Java 项目 / 前端 / Docker / Kubernetes / GitHub 自动构建），我可以给你更针对性的配置示例。