Jenkins在Debian上的部署流程是怎样的

在 Debian 上部署 Jenkins 的标准流程

一 环境准备

• 操作系统：建议使用 Debian 11/12 稳定版。
• 硬件建议：至少 4GB 内存（生产推荐 8GB+），可用磁盘 10GB+。
• 安装基础工具与 Java：
  • 更新索引并安装依赖：sudo apt update && sudo apt install -y gnupg2 apt-transport-https wget ca-certificates
  • 安装 OpenJDK 11（Jenkins 常用 LTS 运行时）：sudo apt install -y openjdk-11-jdk
  • 验证：java -version 应显示 11.x。

二 安装与启动

• 导入 Jenkins 仓库密钥（推荐新版签名方式，使用 APT 密钥环）：
  • curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
• 添加官方稳定仓库（signed-by 指向密钥环）：
  • 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
• 更新索引并安装 Jenkins：
  • sudo apt update && sudo apt install -y jenkins
• 启动并设置开机自启：
  • sudo systemctl start jenkins
  • sudo systemctl enable jenkins
  • 检查状态：sudo systemctl status jenkins（应为 active (running)）。

三 防火墙与端口

• 开放访问端口（默认 8080 用于 Web；如部署 Agent 需开放 50000/TCP 用于 JNLP/agent 通信）：
  • UFW：sudo ufw allow 8080/tcp，sudo ufw allow 50000/tcp，sudo ufw reload
  • firewalld：sudo firewall-cmd --permanent --add-port=8080/tcp，sudo firewall-cmd --permanent --add-port=50000/tcp，sudo firewall-cmd --reload
• 云服务器请在安全组放行对应端口。

四 初始化与基础配置

• 访问 Web 界面：http://<服务器IP>:8080
• 解锁 Jenkins：查看初始管理员密码
  • sudo cat /var/lib/jenkins/secrets/initialAdminPassword
• 完成安装向导：
  • 选择 Install suggested plugins 或按需安装常用插件：Pipeline、GitHub Integration、Docker、Kubernetes CLI、Credentials Binding
  • 创建管理员账户，完成安全配置（建议禁用匿名访问）
• 可选优化：
  • 插件更新加速：进入 Manage Jenkins → Plugin Manager → Advanced，将 Update Site URL 替换为 https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
  • 全局工具配置：在 Manage Jenkins → Global Tool Configuration 配置 JDK、Git、Maven、Docker 等路径或自动安装。

五 常见问题与扩展

• 安装时报依赖错误（如缺少 daemon）：先 sudo apt install -y daemon 再安装 Jenkins。
• 仓库密钥方式兼容：部分旧教程使用 apt-key add 添加密钥，功能等同；但更推荐使用 /usr/share/keyrings/ 的签名方式。
• 离线或网络慢：可手动下载 .deb 包安装（示例：wget https://repo.huaweicloud.com/jenkins/debian/jenkins_2.380_all.deb，然后 sudo dpkg -i jenkins_2.380_all.deb），或临时使用国内镜像源。
• 扩展为集群：在主节点 Manage Jenkins → Manage Nodes and Clouds 添加 Agent 节点，确保节点间网络与 8080/50000 端口可达，节点 Java 版本一致，插件版本兼容。