GitLab代码托管与CI教学培训

20XX/XX/XXGitLab代码托管与CI教学培训汇报人:XXXCONTENTS目录01

课程入门与基础准备02

GitLab代码托管基础操作03

GitLabCI核心流程配置04

典型开发实践场景演练05

常见问题与课程总结课程入门与基础准备01掌握GitLab核心基础操作熟练完成代码的提交、拉取、分支管理等操作，能独立在GitLab平台完成代码托管全流程。精通CI流水线搭建与调试学会编写.gitlab-ci.yml配置文件，可搭建并调试简单的自动化构建、测试流水线。具备GitLab协作开发能力掌握MergeRequest、代码评审等协作功能，能参与多人协同的代码开发项目。课程学习目标说明GitLab基础环境搭建服务器硬件与系统选型推荐选用2核4G以上服务器，系统优先选Ubuntu20.04或CentOS7，满足GitLab运行基础需求。GitLab官方包安装配置通过GitLab官方源下载安装包，执行dpkg命令完成安装，再通过配置文件调整端口等参数。初始访问与管理员设置安装完成后通过服务器IP访问，设置初始管理员密码，创建首个项目测试环境可用性。GitLab代码托管基础操作02代码仓库创建与配置

新建空白代码仓库登录GitLab后，在项目页面点击“新建项目”，选择空白仓库类型，填写名称后即可完成创建。

配置仓库访问权限可设置私有、内部或公开权限，如将企业项目设为私有，仅授权团队成员查看操作。

添加仓库协作成员通过成员管理界面添加团队成员，分配开发者、维护者等角色，如给核心开发设维护者权限。Git工作区代码暂存与提交开发者可通过gitadd将本地修改文件暂存，用gitcommit提交至本地仓库，如提交修复bug的代码变更。GitLab远程仓库分支创建与切换在GitLab中可创建feature分支开发新功能，通过gitcheckout切换分支，避免影响主分支稳定性。分支合并与冲突解决完成开发后将分支合并到主分支，若遇代码冲突，可借助GitLab界面或本地工具手动协调修改。代码提交与分支管理合并请求与审核流程

创建合并请求开发者完成分支代码后，在GitLab发起合并请求，需填写修改说明，关联对应任务ID。

代码审核标注审核者通过GitLab界面批注代码问题，如字节跳动团队常用该功能优化代码质量。

合并请求执行审核通过后，由项目负责人将分支代码合并至主分支，同步更新版本日志。权限与成员管理设置

项目角色权限分配GitLab提供Guest、Reporter、Developer等角色，可给前端开发者分配Developer权限，允许其提交代码。

成员邀请与移除操作管理员可通过邮箱邀请新成员加入项目，若成员离职，可一键移除其项目访问权限保障安全。

组层级权限批量配置针对多子项目的组，可统一设置组内成员权限，如给测试组全员分配Reporter权限查看代码。通过commitID精准回溯版本在GitLab中输入指定commitID，可直接回溯到对应版本，比如恢复某段误删的核心业务代码。利用分支对比回溯历史版本将当前分支与历史分支对比，可清晰查看版本差异，像排查线上bug时定位代码变更节点。借助标签快速回溯里程碑版本给关键版本打标签后，通过标签可一键回溯，例如回溯到V1.0正式发布的代码版本。代码仓库版本回溯GitLabCI核心流程配置03CI/CD基础概念讲解持续集成（CI）定义解析持续集成指开发人员频繁合并代码至共享仓库，通过自动构建、测试保障代码质量，如谷歌每日多次集成代码。持续交付（CD）核心内涵持续交付是在CI基础上，将代码自动部署至预生产环境，确保随时可发布，像亚马逊可快速交付更新版本。CI与CD的关联差异CI侧重代码集成与质量校验，CD延伸至交付部署环节，二者协同实现从代码到产品的高效自动化流转。.gitlab-ci.yml语法说明

核心关键字定义需明确stages、jobs、script等核心关键字，比如stages可定义build、test、deploy等流程阶段。

变量与模板配置支持自定义变量及模板复用，如定义IMAGE_NAME变量，用extends引用通用模板简化配置。

条件判断语法可通过only、except等语法设置触发条件，比如仅在main分支提交时执行deploy任务。定义阶段执行顺序通过stages关键字设定build、test、deploy等阶段顺序，确保CI流程按预设逻辑依次推进。配置单阶段多作业在同一阶段下设置并行作业，如test阶段同时运行单元测试与代码扫描，提升校验效率。关联阶段与作业归属使用stage字段指定作业所属阶段，例如将打包任务归入build阶段，实现流程精准管控。阶段与作业配置方法镜像与变量管理CI/CD运行镜像配置可选用官方Node.js、Python等镜像，也能自定义镜像，比如基于Ubuntu构建适配项目的专属运行环境。全局变量统一管理在GitLab项目Settings中配置全局变量，如数据库密码，可在所有CI任务中复用，提升配置效率。环境变量按需设置针对测试、生产等不同环境设置专属变量，比如测试环境API地址，实现多环境流程差异化配置。流程触发规则设置

分支提交触发配置可设置仅当代码提交至指定分支（如main、develop分支）时，自动触发CI流水线执行。

标签推送触发配置可配置当推送特定版本标签（如v1.0.0正式版标签）时，触发CI流水线进行版本构建。

手动触发规则配置可设定特定流水线仅支持手动触发，常用于需要人工确认的重要版本发布场景。典型开发实践场景演练04Java项目自动化构建基于Maven的代码编译与打包借助Maven工具，可自动完成Java项目的代码编译、依赖管理，输出可执行Jar包，如SpringBoot项目常用该方式。基于GitLabCI的多环境自动化部署配置.gitlab-ci.yml文件，实现Java项目在开发、测试、生产环境的自动部署，提升交付效率。自动化单元测试与代码质量检查集成JUnit、SonarQube工具，在构建阶段自动执行单元测试、扫描代码漏洞，保障Java项目质量。代码静态检查集成

SonarQube与GitLabCI流水线对接通过配置.gitlab-ci.yml文件，将SonarQube代码检测嵌入流水线，提交代码后自动触发漏洞扫描。

自定义检查规则配置结合团队代码规范，在SonarQube中定制检查规则，如禁用不安全函数、规范变量命名等。

检查结果自动化闭环处理设置GitLabCI阈值，当代码问题超标时阻断合并请求，推动开发者及时修复代码缺陷。自动化单元测试执行

01基于GitLabCI配置单元测试流水线借助GitLabCI的.gitlab-ci.yml文件，配置JUnit等测试框架的执行脚本，实现代码提交即触发测试。

02测试结果可视化与失败告警GitLab会自动生成测试报告，展示通过率等数据，测试失败时通过邮件、Slack及时通知开发人员。

03测试覆盖率统计与质量门禁设置集成JaCoCo等工具统计代码覆盖率，在GitLabCI中设置门禁，覆盖率不达标则阻止代码合并。项目镜像打包推送编写Dockerfile定义镜像以Java项目为例，编写Dockerfile指定基础镜像、复制jar包、配置启动命令，完成镜像构建规则定义。使用Docker构建项目镜像执行dockerbuild命令，结合编写好的Dockerfile，将本地SpringBoot项目打包为可运行镜像。推送镜像至GitLab容器注册表登录GitLab容器注册表后，执行dockerpush命令，将构建好的镜像推送至指定仓库供后续拉取使用。常见问题与课程总结05CI流水线启动失败排查先检查.gitlab-ci.yml语法是否有误，可借助GitLab内置的Lint工具快速定位语法问题。代码提交后镜像构建失败排查优先查看Dockerfile指令是否合规，比如是否存在依赖包拉取失败的情况，参考官方镜像示例调整。流水线权限不足故障排查检查项目CI/CD变量配置，确认是否赋予了流水线拉取私有镜像、访问仓库的对应权限。常见故障排查方法核心知识点回顾总结