温馨提示×

ubuntu下jenkins怎么设置

小樊
36
2026-10-18 22:48:22
栏目: 智能运维

在 Ubuntu 下部署和配置 Jenkins,一般可以按下面的步骤来(以 Ubuntu 20.04 / 22.04 为例,其他版本类似)。


一、安装 Jenkins(Ubuntu)

1. 安装 Java(Jenkins 依赖 Java)

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

Jenkins 2.4xx 推荐 Java 17;老版本可用 Java 11。

验证:

java -version

2. 添加 Jenkins 官方源

sudo apt install -y curl gnupg
curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo tee \
  /usr/share/keyrings/jenkins-keyring.asc > /dev/null

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

3. 安装 Jenkins

sudo apt update
sudo apt install -y jenkins

4. 启动并设置开机自启

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

二、初次访问与初始化

1. 开放端口(默认 8080)

sudo ufw allow 8080

浏览器访问:

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

2. 获取初始管理员密码

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

复制到页面中完成初始化。


3. 安装推荐插件

  • 选择 Install suggested plugins
  • 创建管理员账号
  • 完成配置

三、Jenkins 基础设置

1. 修改 Jenkins 端口(可选)

编辑:

sudo nano /etc/default/jenkins

修改:

JENKINS_PORT=8090

重启:

sudo systemctl restart jenkins

2. 配置 JDK / Maven / Git

Manage Jenkins → Global Tool Configuration

  • JDK:指定 /usr/lib/jvm/java-17-openjdk-amd64
  • Git:通常已自动识别
  • Maven:可自动安装或指定路径

3. 配置用户权限(可选)

Manage Jenkins → Security

  • 启用“Logged-in users can do anything”
  • 或安装 Role-based Authorization Strategy

四、常见使用场景

1. 创建 Freestyle 项目

  • New Item → Freestyle project
  • 配置 Git 仓库
  • 添加构建步骤(Shell / Maven)

示例 Shell:

echo "build start"
mvn clean package

2. 配置 Webhook(Git 自动构建)

  • 安装 GitHub / GitLab 插件
  • 项目 → Build Triggers → 勾选 webhook
  • Git 仓库配置 Jenkins URL

五、常见问题

1. Jenkins 无法启动

journalctl -u jenkins -f

常见原因:

  • Java 没装
  • 端口被占用

2. 忘记管理员密码

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

修改:

<useSecurity>false</useSecurity>

重启 Jenkins 后重新设置。


如果你能告诉我:

  • ✅ Ubuntu 版本
  • ✅ 用途(Java / Python / Docker / 前端)
  • ✅ 是否要 Docker 部署

我可以给你更精确的配置方案。

0 踩