Debian系统Jenkins安装步骤

Debian 系统安装 Jenkins 步骤

一 环境准备

• 更新系统并安装 Java 11（Jenkins 2.x 常用版本为 Java 8/11）：
  • 执行：sudo apt update && sudo apt install -y openjdk-11-jdk
  • 验证：java -version
• 建议资源：测试环境至少 4 核 CPU / 8GB 内存 / 50GB 存储；生产环境建议 8 核 CPU / 16GB 内存 / 100GB 存储（可按需扩展）。

二 安装 Jenkins（APT 方式）

• 导入 Jenkins GPG 密钥（推荐采用签名文件方式）：
  • 执行：curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
• 添加官方 APT 源（稳定版）：
  • 执行：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
• 安装并启动服务：
  • 执行：sudo apt update && sudo apt install -y jenkins
  • 开机自启：sudo systemctl enable jenkins
  • 启动服务：sudo systemctl start jenkins
  • 检查状态：sudo systemctl status jenkins（应为 active (running)）。

三 防火墙与端口

• 开放 8080（Web 访问）与 50000（Agent 通信）端口：
  • UFW：sudo ufw allow 8080/tcp 与 sudo ufw allow 50000/tcp，然后 sudo ufw reload
  • firewalld：sudo firewall-cmd --permanent --add-port=8080/tcp --add-port=50000/tcp && sudo firewall-cmd --reload
• 访问地址：http://<服务器IP>:8080。

四 初始化配置

• 获取并输入初始管理员密码：
  • 执行：sudo cat /var/lib/jenkins/secrets/initialAdminPassword
  • 将输出内容粘贴到 Web 初始化页面的“解锁 Jenkins”输入框。
• 插件与账户：
  • 选择 Install suggested plugins 安装常用插件，或按需自定义。
  • 创建 管理员账户 并完成 Jenkins URL 等基础配置。
• 可选优化（插件下载加速）：
  • 进入 Manage Jenkins → Plugin Manager → Advanced，将 Update Site 替换为：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
  • 常用插件示例：Pipeline、GitHub Integration、Docker、Kubernetes CLI、Credentials Binding。

五 常见问题与替代方案

• 依赖问题处理：
  • 若安装时报错 “jenkins : Depends: daemon but it is not installable”，可执行：sudo add-apt-repository universe 后重新安装；或单独安装 sudo apt install -y daemon。
• 其他安装方式（简要）：
  • WAR 包运行：java -jar jenkins.war（需已安装 Java，适合快速试用或容器化场景）。
  • Docker 运行（示例）：
    • 执行：docker run -d -p 8080:8080 -p 50000:50000 -v jenkins-data:/var/jenkins_home jenkins/jenkins:lts
    • 说明：映射 8080/50000 端口并持久化 /var/jenkins_home 数据目录。