温馨提示×

debian jenkins怎样设置

小樊
48
2026-09-26 06:49:17
栏目: 智能运维

下面按最常见的场景给你一套在 Debian 上安装并配置 Jenkins 的实用步骤(含关键设置点)。如果你已有部分环境,可跳过对应步骤。


一、安装前的准备(Debian)

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装 Java(Jenkins 依赖)

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

sudo apt install -y openjdk-17-jdk

验证:

java -version

二、安装 Jenkins(官方源,推荐)

1. 添加 Jenkins 仓库

sudo apt install -y curl gnupg
curl -fsSL https://pkg.jenkins.io/debian/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 binary/ | sudo tee \
  /etc/apt/sources.list.d/jenkins.list > /dev/null

2. 安装 Jenkins

sudo apt update
sudo apt install -y jenkins

三、启动与基础设置

1. 启动 Jenkins

sudo systemctl enable jenkins
sudo systemctl start jenkins

查看状态:

sudo systemctl status jenkins

2. 开放端口(默认 8080)

sudo ufw allow 8080

浏览器访问:

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

四、初始化 Jenkins

1. 获取初始管理员密码

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

复制到网页中。

2. 安装插件

  • 推荐:Install suggested plugins
  • 常用插件:
    • Git
    • Pipeline
    • SSH
    • Docker(如需)

3. 创建管理员账号

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


五、Jenkins 常用配置(重点)

1. 修改 Jenkins 端口(可选)

编辑:

sudo nano /etc/default/jenkins

修改:

JENKINS_PORT="8080"

重启:

sudo systemctl restart jenkins

2. 配置 Git

which git

一般在 /usr/bin/git

Jenkins →
Manage Jenkins → Global Tool Configuration → Git


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

路径示例:

  • JDK: /usr/lib/jvm/java-17-openjdk-amd64
  • Maven: 自动安装或指定路径

4. 配置 SSH 凭据(部署用)

Manage Jenkins → Credentials → System → Global credentials

  • 类型:SSH Username with private key
  • 粘贴私钥

六、创建第一个任务(示例)

  1. New Item → Freestyle / Pipeline
  2. 源码管理:Git
  3. 构建步骤:
    • Shell:
      echo "build start"
      ./build.sh
      
  4. 保存 → Build Now

七、生产环境建议(重要)

✅ 使用 Nginx 反向代理
✅ 启用 HTTPS
✅ 定期备份 /var/lib/jenkins
✅ 限制 8080 公网暴露


八、常见问题

Jenkins 启动失败

journalctl -u jenkins -xe

端口被占用

修改 /etc/default/jenkins

权限问题

sudo chown -R jenkins:jenkins /var/lib/jenkins

如果你告诉我:

  • Debian 版本(11 / 12)
  • Jenkins 用途(Java / 前端 / Docker / K8s)
  • 是否要公网访问

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

0 踩