本文基于《Flink电商实时数仓5.0》项目实战教程第8-14集整理而成，旨在整理学习内容和帮助开发者快速搭建实时数仓项目的开发环境与版本控制体系。

一、为什么需要重视环境准备？

在大数据项目开发中，环境搭建往往被初学者视为“边缘事务”——大家更愿意把精力放在Flink计算逻辑、数仓模型设计等“核心”内容上。然而，一个规范、稳定的开发环境，是保证团队协作效率和代码质量的前提。

《Flink电商实时数仓5.0》项目在进入ODS层、DIM层等核心开发之前，用了整整7集来讲解环境准备。这套教程通过思路分析、画图演示、代码开发等多维方式，对数仓的架构过程及整体实现进行了详细的讲解。项目采用企业级分模块开发部署方式，使用Flink 1.17.1，自主部署了GitLab，并采用GitFlow任务流的形式对整体项目进行版本控制。

本文将从代码版本控制的角度出发，完整梳理环境准备的每一个关键步骤。

二、项目技术栈概览

在动手之前，先了解本项目所采用的软件及版本：

组件	版本	用途
Flink	1.17.1	实时计算引擎
Hadoop	3.3.6	分布式存储与计算
Kafka	3.6.1	消息队列，数据管道
Zookeeper	3.7.2	分布式协调服务
HBase	2.4.11	维度数据存储
MySQL	8.0.31	业务数据源
Maxwell	1.29.2	Binlog解析与同步
FlinkCDC	2.4.2	变更数据捕获
Redis	6.0.8	缓存
Doris	2.1.0	实时数据仓库
StreamPark	2.1.4	任务部署与监控
GitLab	16.2.1	代码版本控制

相较于实时数仓4.0版本，5.0升级了项目架构设计和各软件版本，并采用GitFlow任务流的形式对整体项目进行版本控制，最终使用StreamPark对项目进行部署和监控。

三、GitLab安装与基础配置

3.1 为什么选择GitLab？

在团队协作开发中，代码版本控制是不可或缺的一环。本项目选择自主部署GitLab，而非直接使用GitHub或Gitee，主要有以下考虑：

· 数据安全：代码和数据资产保存在企业内部服务器
· 权限灵活：可精细控制每个项目、每个分支的访问权限
· 与CI/CD集成：便于后续接入持续集成流水线

3.2 GitLab安装

GitLab的安装根据不同操作系统有所差异。在Linux环境下，通常通过官方提供的安装包或Docker方式部署。安装完成后，需要通过以下命令初始化并启动服务：

# 以CentOS/RHEL为例
sudo yum install -y gitlab-ce
sudo gitlab-ctl reconfigure
sudo gitlab-ctl start

安装成功后，通过浏览器访问 http://<服务器IP> 即可进入GitLab界面。首次访问需要为root用户设置初始密码。

3.3 GitLab基础配置

安装完成后，还需要进行一些基础配置：

1. 修改访问URL：在 /etc/gitlab/gitlab.rb 中配置 external_url
2. 邮件服务配置：配置SMTP以便发送通知邮件
3. 备份策略：设置定期备份，保障代码数据安全
4. LDAP集成（可选）：对接企业统一认证

四、创建用户与群组（核心步骤）

这是教程第12集的核心内容。规范的权限管理是团队协作的基石。

4.1 创建用户账号

在GitLab中，每个开发人员都需要拥有独立的账号。操作步骤如下：

1. 使用root管理员账号登录GitLab
2. 进入 Admin Area → Users → New User
3. 填写用户信息（姓名、用户名、邮箱）
4. 设置初始密码（或发送设置链接到用户邮箱）
5. 分配角色权限（Developer、Maintainer等）

实际项目中，通常会创建两类用户：

• Leader用户：负责代码审核、合并请求、版本发布
• 开发人员用户：负责日常功能开发和代码提交

4.2 创建群组（Group）

群组用于管理一组相关的项目，便于统一权限控制。操作步骤：

1. 使用root管理员账号登录
2. 进入 Admin Area → Groups → New Group
3. 填写群组名称（如 flink-realtime-warehouse）
4. 设置群组可见性（Private/Internal/Public）
5. 将创建好的用户添加到群组中，并分配相应角色

4.3 权限设计最佳实践

在实际项目中，推荐以下权限管理策略：

· 群组级别：设置基础权限（如所有成员均为Developer）
· 项目级别：对核心分支（如main/master）设置保护，仅Maintainer可合并
· 分支保护：设置“初始推送后完全保护”，禁止直接推送到主分支

五、将初始代码推送到GitLab仓库

完成用户和群组创建后，下一步是将项目初始代码推送到GitLab。

5.1 创建项目

使用Leader用户在群组下创建对应的项目：

1. 进入群组页面 → New Project
2. 选择项目模板（或空白项目）
3. 设置项目名称和可见性

5.2 本地代码推送

# 初始化本地仓库
git init

# 添加远程仓库地址
git remote add origin http://<gitlab-server>/<group>/<project>.git

# 添加代码并提交
git add .
git commit -m "Initial commit: Flink real-time warehouse project"

# 推送到远程仓库
git push -u origin main

5.3 配置.gitignore

在推送前，务必配置 .gitignore 文件，排除不需要提交到版本库的内容：

• IDE配置文件（.idea/、*.iml）
• 日志文件（*.log）
• 本地配置文件（application-local.properties）
• 编译输出目录（target/、out/）

5.4 IDEA集成GitLab

在实际开发中，开发者通常通过IDEA等IDE直接与GitLab交互。可以安装 GitLab Project插件，实现在IDE内直接完成代码提交、推送、创建Merge Request等操作。

六、Kafka分区数设置

在实时数仓项目中，Kafka作为核心的数据管道，其分区数设置直接影响数据吞吐量和消费并行度。

6.1 分区数设置原则

在项目中，需要将Kafka的主题分区数设置为与Flink任务的并行度一致：

# 修改Kafka配置
num.partitions=4  # 假设Flink并发度为4

6.2 为什么要保持一致？

• 保证数据有序：同一Key的数据写入同一分区，Flink消费时按分区并行处理
• 避免数据倾斜：分区数过少会导致部分Task负担过重
• 充分利用资源：分区数应与集群资源和Flink并发度匹配

在电商实时数仓场景中，通常需要为ODS层、DWD层等多个主题分别设置合理的分区数。

七、环境准备阶段的思考与总结

回顾整个环境准备阶段，表面上看只是在“搭环境”，但背后体现的是企业级项目开发的工程化思维：

1. 版本控制先行：在写任何业务代码之前，先把GitLab搭好、权限分好、分支策略定好——这决定了后续开发是否有序。
2. 权限最小化原则：每个开发者只拥有完成工作所需的最小权限，核心分支受到保护。
3. 配置与代码分离：通过 .gitignore 排除本地配置文件，避免不同开发环境相互干扰。
4. 基础设施即代码：GitLab、Kafka等组件的配置也应文档化、版本化。

整个教程后续将进入ODS层日志数据采集、DIM层维度数据处理、DWD层事实数据处理等核心开发阶段。而本阶段打下的环境基础，将在后续每一行代码的提交、每一次版本的发布中持续发挥作用。

参考资料

• 《Flink电商实时数仓5.0》，教程通过思路分析、画图演示、代码开发等多维方式，对数仓的架构过程及整体实现进行了详细讲解