温馨提示×

Jenkins在Ubuntu如何配置

小樊
39
2026-09-28 10:33:55
栏目: 智能运维

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


一、环境准备

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装 Java(Jenkins 依赖)

Jenkins 需要 Java 11 或 Java 17

sudo apt install openjdk-17-jdk -y

验证:

java -version

二、安装 Jenkins

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

1. 导入 Jenkins GPG 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. 安装 Jenkins

sudo apt update
sudo apt install jenkins -y

三、启动 Jenkins

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

看到 active (running) 即成功。


四、初次访问与初始化

1. 获取管理员密码

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

2. 浏览器访问

http://<服务器IP>:8080
  • 输入密码
  • 选择 Install suggested plugins
  • 创建管理员账号
  • 完成初始化

五、基础配置

1. 修改 Jenkins 端口(可选)

编辑:

sudo nano /etc/default/jenkins

修改:

HTTP_PORT=8080

重启:

sudo systemctl restart jenkins

2. 配置自动化构建用户(推荐)

sudo usermod -aG docker jenkins
sudo systemctl restart jenkins

六、常见插件推荐

在 Manage Jenkins → Plugins 中安装:

  • Git
  • GitHub
  • Docker
  • Pipeline
  • Blue Ocean
  • SSH Agent

七、配置第一个 Jenkins Job(示例)

  1. 新建 Item → Freestyle project
  2. Source Code Management → Git
  3. Build Steps → Execute shell
  4. 示例脚本:
echo "Hello Jenkins"

八、防火墙(如开启)

sudo ufw allow 8080

九、常见问题

1. 页面打不开

  • 检查服务状态
  • 检查云服务器安全组
  • 查看日志:
sudo journalctl -u jenkins

2. Jenkins 无法执行 docker

  • jenkins 用户加入 docker 组
  • 重启 Jenkins

如果你需要:

  • ✅ Jenkins + Docker 自动化部署
  • ✅ Jenkins Pipeline 示例
  • ✅ Jenkins + GitLab / GitHub Webhook
  • ✅ Jenkins 反向代理(Nginx)

告诉我你的使用场景,我可以直接给你完整配置示例。

0 踩