温馨提示×

如何配置ubuntu的jenkins

小樊
38
2026-09-07 08:43:35
栏目: 智能运维

下面按从零开始的思路,给你一份在 Ubuntu 上配置 Jenkins 的实用指南(以 Ubuntu 20.04 / 22.04 为例,其他版本类似)。


一、安装 Java(Jenkins 依赖)

Jenkins 需要 Java 11 或 Java 17。

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

验证:

java -version

二、安装 Jenkins

方法一:官方仓库安装(推荐)

# 导入 GPG 密钥
sudo wget -O /usr/share/keyrings/jenkins-keyring.asc \
  https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key

# 添加 Jenkins 源
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

三、启动 Jenkins

sudo systemctl enable jenkins
sudo systemctl start jenkins
sudo systemctl status jenkins

四、开放防火墙(如有)

sudo ufw allow 8080

访问:

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

五、初始化 Jenkins

1. 获取管理员密码

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

复制到网页中。

2. 安装插件

  • 推荐:Install suggested plugins
  • 常用插件:
    • Git
    • GitHub
    • Docker
    • Pipeline
    • SSH Agent

3. 创建管理员用户


六、基本配置

1. 配置 JDK

Manage Jenkins → Global Tool Configuration

  • 添加 JDK
  • 取消“Install automatically”(如已手动安装)

2. 配置 Git

which git

在 Jenkins 中指定 git 路径(通常 /usr/bin/git

3. 配置 Maven / Node(按需)

  • Maven:Global Tool Configuration → Maven
  • Node.js:安装 NodeJS 插件后配置

七、创建第一个任务(Freestyle)

  1. New Item → Freestyle project
  2. Source Code Management → Git
    https://github.com/your/repo.git
    
  3. Build Steps
    • Execute shell:
      echo "Hello Jenkins"
      
  4. 保存 → Build Now

八、使用 Pipeline(推荐)

示例 Jenkinsfile

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

九、常见配置问题

Jenkins 无法启动

journalctl -u jenkins -n 50

端口修改

编辑:

sudo nano /etc/default/jenkins

修改:

JENKINS_PORT=9090

重启:

sudo systemctl restart jenkins

十、进阶(可选)

  • 反向代理(Nginx + HTTPS)
  • Jenkins + Docker
  • Jenkins + GitHub Webhook
  • 分布式 Slave 节点

如果你愿意,我可以:

  • 帮你写 Jenkinsfile
  • 配置 Docker 构建
  • 配置 Nginx + HTTPS
  • 或针对 Ubuntu 版本 / 使用场景 细化步骤

直接告诉我你的需求即可。

0