温馨提示×

如何配置jenkins ubuntu

小樊
39
2026-09-28 11:02:57
栏目: 智能运维

下面按在 Ubuntu 上安装并配置 Jenkins的常见流程给你一个实用指南(以 Ubuntu 20.04 / 22.04 为例,适用于大多数情况)。


一、安装前的准备

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装 Java(Jenkins 依赖)

Jenkins 需要 Java 11 或 Java 17(推荐 Java 17)

sudo apt install openjdk-17-jdk -y

验证:

java -version

二、安装 Jenkins

方式一(推荐):使用官方仓库

1. 添加 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

2. 安装 Jenkins

sudo apt update
sudo apt install jenkins -y

三、启动 Jenkins

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

如果看到 active (running) 说明启动成功。


四、配置防火墙(如有)

sudo ufw allow 8080
sudo ufw enable

五、初始化 Jenkins

1. 浏览器访问

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

2. 获取初始管理员密码

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

复制密码粘贴到页面中。

3. 安装插件

  • 推荐:Install suggested plugins
  • 或自定义(Git、Pipeline、Docker 等)

4. 创建管理员用户

按提示设置用户名、密码、邮箱。


六、基础配置

1. 修改 Jenkins 端口(可选)

编辑:

sudo nano /etc/default/jenkins

修改:

HTTP_PORT=8080

重启:

sudo systemctl restart jenkins

2. 配置 Git

sudo apt install git -y

Jenkins → Manage Jenkins → Global Tool Configuration → Git


3. 配置 JDK / Maven / Node(按需)

在 Global Tool Configuration 中自动安装或指定路径。


七、常见实用配置

1. 使用 Nginx 反向代理(推荐)

sudo apt install nginx -y

示例配置:

server {
    listen 80;
    server_name jenkins.example.com;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}
sudo nginx -t
sudo systemctl restart nginx

2. 配置开机自启

sudo systemctl enable jenkins

八、常见问题

Jenkins 启动失败

journalctl -u jenkins -xe

Java 版本不对

which java

确保 /usr/lib/jvm/java-17-openjdk 被使用。


如果你需要:

  • Docker 安装 Jenkins
  • Jenkins + GitLab / GitHub 自动构建
  • Pipeline 示例
  • Jenkins 权限管理

可以告诉我你的使用场景,我可以给你更具体的配置方案。

0 踩