Skip to main content
GitLab 运维与 CI 实践

围绕 GitLab 攒的几块运维笔记:Releases 发布、Geo 副站、UI 解冲突、CI 分支过滤、Jenkins 拉 Shared Library。

GitLab Releases 发布流程

GitLab 的 Release 里挂版本包链接时,要求是 https 协议。所以如果自己搭了个内网下载服务器(比如 Tomcat),得先给它配上 https,否则链接填不进去。整体三步:搭 Tomcat → 配自签名证书走 https → 在 GitLab 上建 Release。

搭 Tomcat 当下载服务器

  1. 装 JDK,配好 JAVA_HOME、Path(加 %JAVA_HOME%\bin)、CLASSPATH 环境变量。java -version 能输出版本就算装好。
  2. 下 Tomcat 免安装压缩包解压,配 CATALINA_HOME 并把 %CATALINA_HOME%\bin 加进 Path。
  3. 双击 bin\startup.bat 启动(窗口别关),shutdown.bat 停。浏览器开 http://localhost:8080/ 能出页面就 OK。
  4. 把版本发布目录(例:D:\MyProject_Release)设成共享文件夹并配好权限,再在 Tomcat 里建一个映射这个目录的配置,这样局域网里就能 http://<server-ip>:8080/shareFolder/... 访问到包了。
Plastic SCM 教程：概念、安装与操作

这篇是用 Plastic SCM（Unity Version Control）的上手笔记，从概念对照、安装登录，到在 GUI 客户端和 Unity 编辑器里的日常操作、文件忽略、分支和仓库迁移。习惯了 Git/P4 的人，先看概念对照表能少踩很多坑。

概念对照

Plastic 的术语和 Git/Perforce 不完全对得上，对照着记最快：

Plastic SCM Git Perforce 说明
Checkin Commit Submit 把改动提交到仓库。
Changeset Commit Changelist 每次 checkin 创建一个新的 changeset（书里缩写为 cset / csets）。
Update Checkout Sync 把内容下载到本地工作副本。比如切到别的分支时就会发生。
Checkout --- Edit 在 Plastic 里 checkout 一个文件，是在告诉 Plastic 你打算改它。非强制，可跳过；但如果用了锁（独占访问），checkout 就是强制的。
main master main 即 Subversion 里的 trunk。创建仓库时 main 分支必然存在；Plastic 里可以安全地重命名它。
Repository Repository Depot 存放所有版本、分支、合并的地方。
Workspace Working tree Workspace 项目下载到本地磁盘、你实际干活的目录。Git 里仓库和工作副本紧绑（仓库在工作副本的 .git 里）；Plastic 里同一个仓库可以有任意多个工作区。
版本控制系统笔记

平时在游戏项目里打交道最多的几套版本控制：Perforce（美术大仓库的事实标准）、Git/GitLab（代码与 CI）、SVN（老项目）、Plastic SCM（Unity 向）。这一组笔记按工具分目录，多数是命令速查、服务端搭建、CI 集成、踩坑记录。

Perforce（P4）

  • P4 常用命令速查——revert/flush/reconcile/submit 等日常命令，加上批量操作、特殊字符、卡顿处理这些实战片段。
  • P4IGNORE 与 typemap——忽略规则的默认文件名、配置示例与调试，外加一份 UE 项目完整 typemap 模板。
  • P4 Stream 实战——mainline/dev/release/virtual/task 各类流、路径类型、Sparse Stream 的取舍与转换。
  • P4V 图形界面速查——sync/checkout/shelve/merge/branch/clean、undo changelist、同步到指定版本。
  • P4 服务端搭建与运维——服务端安装配置、checkpoint/verify 维护、Proxy 缓存预加载、并行同步、changelist 访问控制。
  • P4Python——密码/Ticket 两种登录方式，Jenkins SCM 流水线里 run_sync 后取 changelist 号，reconcile 空返回的解析。
  • P4 Swarm 代码审查——Swarm 安装与 config.php、Review 流程（Requester/Reviewer 双视角）、触发 Jenkins 构建并回调、Nginx 反代加 HTTPS、单 Swarm 连多 P4 服务器。
P4 Stream 与 Sparse Stream

Stream 是 P4 的分支模型,比手工维护 branch mapping 省心很多——分支视图自动生成 workspace view 和 branch view。这篇记 Stream 的基本概念、四种路径类型、创建流程,以及更轻量的 Sparse Stream 和并行 sync 配置。

Stream 基础

Stream 存放在 Stream depot 里,这是一种与标准 depot 平行的特殊 depot。

三种标准 Stream 类型:

  • Mainline:整个 stream 体系的主干。
  • Development:长期项目、大的新功能。
  • Release:修 bug、测试、发布分发。
Perforce 服务端搭建:Server、Proxy、Trigger 与 UE 工程

这篇把我搭 P4 服务端时踩过、查过的东西归到一处:单机和多实例的 Server/Proxy 怎么装、日常用哪些命令管服务、checkpoint 和 verify 怎么排期、trigger 怎么配,以及给 UE4 工程做 typemap 和权限表时要注意什么。命令基于 P4 Server 2015.2,部分配置项更早的版本没有。

安装前准备

Git 分支管理与常用命令

平时用 Git 攒下来的一些手边命令,按场景分组记一下,免得每次都去翻文档。

远程分支的增删改

新建并推送分支

基于某个 commit 建分支再推到远程:

git branch <branch_name> <commit_sha>
git push -u origin <branch_name>
git checkout -f <commit_sha>
P4V 基本操作

P4V 是 P4 的图形客户端。这篇记从登录、建 workspace 到日常各项操作的含义,基于 v2018.4,后续版本界面略有出入但概念一致。

登录与建 workspace

  1. 打开 P4V,填服务器地址 <P4SERVER>:1666、端口和用户名。
  2. 新建 workspace(首次登录要新建 workspace 并输入密码)。

标准 Depot:

  1. 设 workspace 名。
  2. 设本地 workspace 路径(在这里干活)。
  3. 设 workspace 映射(包含你需要的文件夹)。不清楚 depot 的 view 结构时,点对应图标把 view 以树形展开,再选择 Include / Exclude / Clear 各个目录。
P4IGNORE 与 Typemap

新建一个 P4 仓库,头两件要配的事就是 P4IGNORE(别把临时文件、本地配置加进去)和 typemap(让二进制资源加锁、文本文件按文本处理)。这篇把这两块的配置方式和我用的模板攒在一起。

P4IGNORE

P4IGNORE 只对正在被 add 的文件生效,不会忽略已经在 depot 里的文件。

默认文件名

2023.2 之前的 Helix Core Server 没有默认规则文件名。从 2023.2 起,满足下列条件就会自动查找默认文件名:

  • Helix Core Server 2023.2 及以上
  • 兼容的客户端,比如 2023.2 Server 自带的 p4 client,或 P4V 2023.4 及以上
git-p4 桥接:用 Git 操作 Perforce

团队主仓库在 Perforce(P4),但自己想用 Git 的工作流,这时候 git-p4 就派上用场。它把 P4 depot 映射成本地 Git 仓库,在本地用 Git 提交,再同步回 P4。

工作模型先理清

用之前得先搞清几条规则,不然提交会报错:

  • git-p4 是一个用 Git 来操作 P4 的桥接工具。
  • Git 远程仓库(如果你同时挂了一个)不允许直接 push。
  • 本地的 Git commit 必须先 submit 到 P4,然后才能 push 到 Git 远程仓库。
  • 如果 P4 和本地 Git 冲突,push 时会自动 rebase。
  • 如果 Git 远程仓库里有还没 submit 到 P4 的 commit,git-p4 submit 会报错。