1. DevOps工具链部署概述在现代化软件开发流程中持续集成与持续交付(CI/CD)已成为不可或缺的环节。作为DevOps工具链中的两大核心组件GitLab和Jenkins的协同部署能够为开发团队提供完整的代码管理、自动化构建和部署能力。GitLab作为一体化的DevOps平台提供了从代码托管到CI/CD的全套解决方案而Jenkins作为老牌的自动化服务器则在构建流程的灵活性和插件生态方面具有独特优势。在实际生产环境中我们通常会遇到以下典型需求场景开发团队需要将代码变更自动触发构建和测试流程运维团队需要可靠的方式将构建产物部署到不同环境项目管理者需要实时了解构建状态和部署进度安全团队需要对整个流程进行权限控制和审计2. 环境准备与基础安装2.1 系统要求与依赖检查在开始安装前我们需要确保系统满足以下最低要求硬件要求CPU至少4核推荐8核内存8GB推荐16GB磁盘空间50GB可用空间SSD推荐软件依赖操作系统Rocky Linux 9.5/Ubuntu 22.04 LTS/CentOS Stream 9JavaOpenJDK 11Jenkins依赖Ruby2.7GitLab依赖PostgreSQL12GitLab可选Redis6.0GitLab可选提示对于生产环境建议将GitLab和Jenkins部署在独立的服务器上以避免资源竞争和单点故障问题。2.2 GitLab安装与配置2.2.1 通过官方仓库安装GitLab对于Rocky Linux 9.5系统安装步骤如下# 添加GitLab官方仓库 curl -s https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh | sudo bash # 安装GitLab企业版社区版将gitlab-ee替换为gitlab-ce sudo EXTERNAL_URLhttps://gitlab.yourdomain.com dnf install -y gitlab-ee # 首次配置此过程可能需要较长时间 sudo gitlab-ctl reconfigure安装完成后访问配置的EXTERNAL_URL系统会提示设置管理员(root)密码。首次登录后建议立即进行以下安全配置修改默认管理员密码配置SMTP邮件服务设置HTTPS证书可通过Lets Encrypt自动获取配置备份策略2.2.2 Docker方式部署GitLab对于希望快速体验或资源有限的环境可以使用Docker部署docker run --detach \ --hostname gitlab.yourdomain.com \ --publish 443:443 --publish 80:80 --publish 22:22 \ --name gitlab \ --restart always \ --volume /srv/gitlab/config:/etc/gitlab \ --volume /srv/gitlab/logs:/var/log/gitlab \ --volume /srv/gitlab/data:/var/opt/gitlab \ gitlab/gitlab-ee:latest2.3 Jenkins安装与配置2.3.1 通过官方仓库安装Jenkins对于Rocky Linux 9.5系统# 添加Jenkins仓库 sudo wget -O /etc/yum.repos.d/jenkins.repo \ https://pkg.jenkins.io/redhat-stable/jenkins.repo sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key # 安装OpenJDK和Jenkins sudo dnf install -y java-11-openjdk jenkins # 启动并设置开机自启 sudo systemctl enable --now jenkins # 查看初始管理员密码 sudo cat /var/lib/jenkins/secrets/initialAdminPassword访问http://your-server-ip:8080输入初始密码完成安装向导。建议选择安装推荐插件选项这会包含GitLab插件在内的常用插件。2.3.2 Docker方式部署Jenkins使用Docker部署Jenkins的推荐命令docker run --name jenkins -d \ -p 8080:8080 -p 50000:50000 \ -v jenkins_home:/var/jenkins_home \ jenkins/jenkins:lts-jdk113. GitLab与Jenkins集成配置3.1 GitLab插件安装与配置在Jenkins中安装GitLab插件登录Jenkins管理界面导航到Manage Jenkins Manage Plugins在Available选项卡中搜索GitLab Plugin勾选并安装同时会自动安装依赖插件安装完成后需要进行系统级配置导航到Manage Jenkins Configure System找到GitLab部分添加GitLab服务器连接Name: GitLab-ProductionGitLab host URL: https://gitlab.yourdomain.comCredentials: 添加GitLab API令牌需先在GitLab中生成3.2 项目级集成配置3.2.1 GitLab项目配置在GitLab项目中设置CI/CD集成进入项目设置 Integrations添加Jenkins服务Jenkins server URL: http://jenkins.yourdomain.comProject name: 对应Jenkins中的项目名称Username/Password: Jenkins认证信息3.2.2 Jenkins项目配置创建新的Jenkins项目时选择Freestyle project或Pipeline类型在源码管理部分选择Git配置仓库URL和认证方式在构建触发器部分勾选Build when a change is pushed to GitLab配置高级选项Secret token: 用于验证Webhook请求Allowed branches: 指定触发构建的分支3.3 Webhook配置与测试GitLab通过Webhook通知Jenkins代码变更在GitLab项目设置中进入Webhooks添加新的WebhookURL: http://jenkins.yourdomain.com/project/Secret Token: 与Jenkins配置中一致Trigger: 选择Push events和Merge Request events测试Webhook连接确保返回状态码为2004. 高级配置与优化4.1 安全加固配置4.1.1 GitLab安全配置强制使用HTTPS# /etc/gitlab/gitlab.rb external_url https://gitlab.yourdomain.com nginx[redirect_http_to_https] true配置SSH密钥认证# 生成SSH密钥对 ssh-keygen -t ed25519 -C your_emailexample.com # 将公钥添加到GitLab账户 cat ~/.ssh/id_ed25519.pub | pbcopy设置项目访问权限私有项目默认权限分支保护规则合并请求批准规则4.1.2 Jenkins安全配置启用矩阵权限控制管理 全局安全配置选择Project-based Matrix Authorization Strategy为不同角色分配细粒度权限配置CSRF防护管理 全局安全配置勾选Prevent Cross Site Request Forgery exploits使用Crumb Issuer4.2 性能优化4.2.1 GitLab性能调优调整Sidekiq并发数# /etc/gitlab/gitlab.rb sidekiq[max_concurrency] 20配置缓存gitlab_rails[redis_cache_instance] redis://localhost:6379/10定期执行Housekeepinggit gc --aggressive --prunenow4.2.2 Jenkins性能优化调整JVM参数# /etc/sysconfig/jenkins JAVA_OPTS-Xms4g -Xmx4g -XX:MaxMetaspaceSize512m配置构建代理设置永久性代理节点使用Docker动态代理定期清理构建历史安装Discard Old Build插件配置项目级保留策略4.3 备份与恢复4.3.1 GitLab备份策略创建手动备份sudo gitlab-backup create配置自动备份# /etc/gitlab/gitlab.rb gitlab_rails[backup_path] /var/opt/gitlab/backups gitlab_rails[backup_keep_time] 604800 # 保留7天备份恢复流程sudo gitlab-ctl stop unicorn sudo gitlab-ctl stop sidekiq sudo gitlab-backup restore BACKUPtimestamp sudo gitlab-ctl reconfigure sudo gitlab-ctl restart4.3.2 Jenkins备份策略使用ThinBackup插件配置定期完整备份设置备份保留策略手动备份关键目录/var/lib/jenkins/jobs//var/lib/jenkins/config.xml/var/lib/jenkins/plugins/恢复流程停止Jenkins服务替换备份文件重启服务5. 常见问题排查5.1 认证问题问题现象Login failed. Check API token or GitLab version解决方案确认GitLab API令牌具有足够权限至少需要api范围检查Jenkins中配置的GitLab版本是否与实际匹配验证网络连接是否通畅特别是HTTPS证书是否受信5.2 Webhook问题问题现象Webhook测试返回403错误排查步骤检查Jenkins的CSRF防护配置验证Secret Token是否匹配检查Jenkins匿名用户是否有Job的读取权限5.3 构建触发问题问题现象代码推送未触发Jenkins构建排查步骤检查GitLab项目的Webhook日志验证Jenkins项目的构建触发器配置检查分支过滤规则是否匹配5.4 性能问题问题现象构建队列积压或响应缓慢优化建议增加Jenkins执行器数量配置构建代理节点优化构建脚本减少不必要的步骤5.5 插件兼容性问题问题现象groovy.lang.MissingPropertyException解决方案检查插件版本是否兼容更新相关插件到最新稳定版检查Pipeline脚本语法6. 最佳实践与经验分享在实际生产环境中部署GitLab和Jenkins集成时我们总结了以下经验权限管理遵循最小权限原则为不同角色配置精确的访问控制。GitLab和Jenkins的权限系统要同步考虑。网络配置确保GitLab和Jenkins服务器之间的网络延迟低5ms特别是当处理大型仓库时。构建策略为特性分支启用快速反馈构建只运行单元测试为主分支配置完整构建流程包含集成测试和代码质量扫描使用标签触发生产环境部署监控告警配置Prometheus监控关键指标设置构建失败告警跟踪构建时长趋势灾备方案定期测试备份恢复流程考虑多活部署方案文档化应急操作流程扩展性考虑使用Jenkins Shared Libraries共享通用逻辑开发自定义GitLab模板考虑GitLab CI/CD与Jenkins的混合使用策略维护窗口安排定期的维护时段提前通知团队系统升级计划在低峰期执行资源密集型操作