Jenkins持续集成在Debian上如何搭建

在 Debian 上搭建 Jenkins 持续集成环境

一 环境准备与安装

• 准备环境：建议使用 Debian 10+，至少 4GB 内存、10GB 磁盘，并安装 OpenJDK 11（Jenkins 2.401+ 要求 Java 11 或更高）。
• 安装 Java：
  • sudo apt update & & sudo apt install -y openjdk-11-jdk
  • java -version
• 导入 Jenkins 仓库密钥与源（新版 Debian 推荐使用签名方式）：
  • 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 > /devref
• 安装并启动 Jenkins：
  • sudo apt update & & sudo apt install -y jenkins
  • sudo systemctl start jenkins & & sudo systemctl enable jenkins
  • sudo systemctl status jenkins # 确认状态为 active (running)
    以上步骤完成后，Jenkins 会以服务方式运行，默认监听 8080 端口。

二 首次访问与初始化配置

• 访问地址：在浏览器打开 http://服务器IP:8080。
• 解锁：查看初始管理员密码
  • sudo cat /var/lib/jenkins/secrets/initialAdminPassword
• 完成向导：选择 Install suggested plugins 安装常用插件，创建 管理员账户，确认 Jenkins URL。
• 防火墙放行（如使用 UFW）：
  • sudo ufw allow 8080
    完成以上步骤后即可进入 Jenkins 控制台。

三 常用插件与首个流水线

• 常用插件（按需安装）：
  • Git、Pipeline、GitHub Integration、Docker、Kubernetes CLI、Credentials Binding。
• 创建首个 Pipeline（示例，保存为仓库根目录的 Jenkinsfile）：
  • pipeline { agent any stages { stage(‘拉取代码’) { steps { git ‘https://github.com/your-org/your-repo.git’ } } stage(‘运行测试’) { steps { sh ‘python -m pytest tests/’ } } stage(‘构建打包’) { steps { sh ‘python setup.py build’ } } stage(‘部署’) { steps { sh ‘./deploy.sh’ } } } post { always { mail to: ‘team@example.com’, subject: “构建完成”, body: “构建 ${ currentBuild.fullDisplayName} 已完成” } } }
• 在 Jenkins 中新建 Pipeline 任务，选择 Pipeline script from SCM，配置 Git 仓库地址与凭据，即可按 Jenkinsfile 执行多阶段 CI/CD。

四 安全与运维要点

• 安全加固：
  • 遵循 最小权限原则，使用 角色/权限插件 与 外部认证（如 LDAP/SSO），凭据使用 安全存储，并 定期更新插件。
  • 通过 反向代理 + HTTPS（如 Nginx/Apache + Let’s Encrypt）保护 Web 访问与 Agent 通信。
• 常见权限问题处理：
  • Jenkins 通常以 jenkins 用户运行，构建或部署时对项目目录、日志目录、目标路径无权限会导致失败。
  • 处理示例：
    • sudo chown -R jenkins:jenkins /path/to/project
    • 或 sudo chmod -R 775 /path/to/project（结合团队与合规要求调整）
• 使用 Docker 快速部署（可选）：
  • docker run -d -p 8080:8080 -p 50000:50000 -v jenkins_data:/var/jenkins_home jenkins/jenkins:lts
  • 获取初始密码：docker logs jenkins 或 docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
  • 如需在容器内构建/部署宿主机 Docker，可挂载 /var/run/docker.sock（注意安全风险）。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！