项目背景

在一家公司做 DevOps 相关工作，若干年前为了解决我们自己的痛点，开发了这个产品内部使用，饱受好评，我也就继续维护这个产品。行业的关系，公司难有大发展，但也倒不了，所以氛围宽松，基本上只要自己负责的那摊事不出问题，没人管你干什么。感谢公司对我摸鱼的宽容，做这个产品很开心，因为没有产品经理，没有业绩压力，不用处理无效需求，感觉每行代码都在让产品变得更好。也感谢来自客户的持续反馈，让我不至于空中楼阁鬼画符。

相比 GitHub/GitLab 有什么特点？

开箱即用的符号跳转

我们内部的一个需求是代码 Review 或者在线看代码时，要能够方便跳转到符号定义：

这个功能使用 ANTLR 分析主流语言的语法，并提取符号定义进行增量存储，速度快，占用空间小。目前支持 Java, JavaScript, C, C++, CSharp, Go, PHP, Python, CSS, SCSS, LESS and R 。GitHub 前两年加入了这个功能，但是好像只是针对主分支； GitLab 需要在 CI 里做 LSIF 相关配置，并会占用大量空间。

静态分析结果直接标注在源码上，作为 Review 的辅助信息

当然 GitHub 有很多第三方工具可以做这个事情，但发现的问题都是显示在各个产品自己的网站上，与 Code Review 流程割裂开来了（比如说我们可以直接对某个代码风格问题加 Review 的相关说明等等）。另外这些第三方工具一般都需要额外收费。

Issue 字段和状态可定制，以及和 CI/CD 的深度集成

这里 GitHub/GitLab 的简单的 Open/Close 的状态完全不能满足我们的需求，特别是牵涉到客户创建的 Issue 时，比如说如果开发人员在 Commit 相关代码时 Close 相关 Issue ，客户得到通知会认为这个问题已经解决，会问应该更新到哪个发行版本；而如果在产品发布时 Close 相关 Issue ，测试人员在拿到测试版时也会困扰，因为相关 Issue 还是 Open 状态，不知道应该测试哪些 Issue 。为解决这个问题，我们定制了四个 Issue 状态：Open ，Committed ，Test Ready 和 Released 。当开发人员 Commit 代码时，相关 Issue 自动迁移到 Committed 状态；当包含这些 Commit 的代码被构建并部署到测试环境中时，相关 Issue 自动迁移到 Test Ready 状态，并通知 QA ，QA 可以在 Issue 的详情页面里了解部署到了哪个测试环境；当测试通过代码发布时，相关 Issue 自动迁移到 Released 状态，并通知客户，客户在 Issue 的详情页里可以得知关联的发行版。

强大易用的 Commit/Issue/Build/Pull Request 查询语言

这个也是基于 ANTLR 做的，对语法规则进行预测来实现自动提示。这样无需学习语法就可以直接进行复杂查询，比如下面是我们客户经常做的事情：在升级前查询当前版本和最新版本之前都有哪些改动：

或者查询所有分配给我的高优先级的 Issue ，在指定的两个发行版之间改动了某个文件的所有 Commit 等等。查询可以保存并订阅，这样符合相关条件的事件发生时可以及时得到通知。

全功能的 CI/CD ，无需了解 Yaml 语法，上手非常简单

CI/CD 是花精力最多的部分了，虽然 CI/CD 的定义也是以 Yaml 文件的方式存储在仓库中，但提供了 UI 来生成该文件，用户无需了解任何相关语法即可进行配置

而且在 Commit 页面可以直接运行 CI/CD 任务，使得 GitOps 来的更直观。灵活可定制的 CI/CD 选项页面让非开发人员也可以很容易的进行部署。

部署一个用于构建的集群及其方便，只需一个 helm 命令就可以部署到 Kubernetes 中，将每个构建任务作为 Pod 运行，同时支持 Windows 和 Linux ；在没有 Kubernetes 的环境中，一行 docker 命令即可启动一个构建的 Agent ，而且 Agent 免于维护，自动升级。V 友们可以试试 GitLab 的构建集群配置，相对而言还是比较麻烦的。

摒弃 Organization ，将项目以树形结构组织以方便设置的继承

自从 GitHub 使用 Organization 后，似乎所有类似的软件都采用这种方式来组织项目了。这种方式对于面向公共服务的云平台而言可能比较合适，但对于公司内部使用感觉没有太大必要，而且还会带来很多麻烦，比如 GitLab 在 Group 级提供 Epic 功能，而在 Project 级提供 Issue 功能，但很多用户要求这两个功能能同时在 Group 级和 Project 级提供等等。我们的做法是将项目以树形结构组织，下级项目可以自动继承上级项目的设置，也可以按需复写。这使得大量项目的设置维护非常容易维护。

随时对代码进行标注和讨论，而不用依赖于 Pull Request

在浏览源码或者 Diff 时，可以对任意代码块即时发起讨论。讨论的内容将作为代码文档的一部分（即使代码改动甚至更名），方便其他人事后对代码进行阅读和理解。不同于其他的 Git 工具，代码 Comment 在侧边显示，避免割裂代码上下文，影响阅读。

另外每处讨论形成单独的 Topic ，使相关的人很容易知道哪里有新的改动或回复。

资源占用相比 GitLab 小很多，速度快

个人使用的话，一台 1 核 2G 的机器足够了。比 Gitea/Gogs 的资源占用还是多的，不过如果 Gitea/Gogs 要做类似功能，受限于 Golang 的生态，可能要启动一些其他语言写的微服务（比如各种 Language Server ，Elastic Search 等），最终资源消耗一定不会小。

还有一个优点就是主服务可以运行在 Linux ，Mac ，Windows ，FreeBSD 等多平台上，可以使用内置文件数据库，也可以充分利用公司现有资源连接到 MySql/MariaDB/PostgreSQL/Oracle/SQL Server 等外置数据库。

技术栈

不够时髦，甚至有点羞于启齿，从头到脚 Java 一把撸（之前被一些 V 友喷用 Java 不够云原生😊)。不分前后端，所有的功能在一个 Maven 项目中（ 40 万行代码左右）。使用 Wicket （估计很少人听说）直接把界面交互和后端逻辑封装在一个组件中，大部分配置界面通过 Annotation 自动生成。依赖注射和插件体系基于 Guice 。在 Eclipse 中启动项目大概耗时 20 秒，不过大部分时间热部署，改动代码后直接刷新页面就可以看到改动。

感谢 V 友们支持🙏

一个人（公司摸鱼+业余时间）开发了五年的开源项目：可用于自建 Git 服务，自带看板和 CI/CD，可替代 GitHub/GitLab（功能级的替代，而非小而美）