温馨提示×

jenkins ubuntu怎么配置

小樊
32
2026-10-15 23:44:21
栏目: 智能运维

下面给你一份在 Ubuntu 上安装并配置 Jenkins 的实用指南,从安装到基本配置,适合新手。


一、环境准备

1. 系统要求

  • Ubuntu 20.04 / 22.04(推荐)
  • Java(Jenkins 依赖)

2. 安装 Java

Jenkins 需要 Java 11 或 Java 17(视 Jenkins 版本)

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

验证:

java -version

二、安装 Jenkins

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

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

# 2. 添加 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

# 3. 安装
sudo apt update
sudo apt install -y jenkins

三、启动 Jenkins

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

查看端口(默认 8080):

ss -tulnp | grep 8080

四、初次配置 Jenkins

1. 浏览器访问

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

2. 获取初始密码

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

复制粘贴到网页中。

3. 安装插件

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

4. 创建管理员用户

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


五、基础配置

1. 修改 Jenkins 端口(可选)

编辑:

sudo nano /etc/default/jenkins

修改:

HTTP_PORT=9090

重启:

sudo systemctl restart jenkins

2. 配置 Git

sudo apt install -y git

Jenkins → Manage Jenkins → Global Tool Configuration → Git


3. 配置 JDK / Maven(如需要)

在 Global Tool Configuration 中:

  • JDK
  • Maven
  • NodeJS

六、防火墙配置(如有)

sudo ufw allow 8080
sudo ufw enable

七、常见问题

1. Jenkins 启动失败

查看日志:

sudo journalctl -u jenkins

常见原因:

  • Java 版本不对
  • 端口被占用

2. 忘记管理员密码

sudo nano /var/lib/jenkins/users/admin/config.xml

或重置用户目录。


八、进阶建议

  • 使用 Nginx + HTTPS
  • 使用 Pipeline as Code
  • 集成 Docker / K8s

如果你告诉我:

  • Ubuntu 版本
  • Jenkins 用途(Java / 前端 / CI CD)
  • 是否用 Docker

我可以给你更针对性的配置方案。

0 踩