gerritcodereview/gerrit

Gerrit Code Review Docker 镜像

简介

Gerrit Code Review 官方 Docker 镜像提供开箱即用的配置，包含 H2 数据库和 DEVELOPMENT 账户设置。
该镜像可直接用于培训或 staging 环境；若用于生产，需作为基础镜像，自定义 gerrit.config 并配置持久化外部模块。

快速启动

以下步骤可快速启动 Gerrit 的演示/ staging 环境：

1. 运行 Docker 命令：

   bash
   docker run -ti -p 8080:8080 -p 29418:29418 gerritcodereview/gerrit
   

2. 等待几分钟，直至出现 Gerrit Code Review NNN ready 消息（NNN 为当前 Gerrit 版本）。

3. 打开浏览器访问 `[***] 即可使用 Gerrit。

注意：若 Docker 服务器运行在远程主机，需将 localhost 替换为远程主机的域名或 IP。

从 2.14 版本开始，新增引导页面，可指导基础操作并从 Gerrit CI 下载安装额外插件。

如需运行指定版本（如 3.3.0），可使用带标签的镜像：
CODE_TOKEN_1

构建 Docker 镜像

构建已发布版本

Git 仓库中已为各 Gerrit 版本（如 3.3.0）打标签，标签指向对应版本 Dockerfile 的代码状态。构建步骤：

1. 检出目标版本标签：
   CODE_TOKEN_2

2. 进入系统对应目录（centos/8 或 ubuntu/20），运行构建命令：
   CODE_TOKEN_3

构建开发版本

如需测试自定义 Gerrit 构建，通过 GERRIT_WAR_URL 参数指定 Gerrit war 包 URL：
CODE_TOKEN_4
默认 URL 指向 Gerrit CI 上 master 分支的最新成功构建结果。

使用持久卷

通过 Docker 持久卷可在重启后保留 Gerrit 数据。以下是 docker-compose.yaml 示例，挂载 Git 仓库、索引和缓存目录：

CODE_TOKEN_5

运行 docker-compose up 启动配置。

环境变量

可通过以下环境变量修改 Gerrit 配置：

• CANONICAL_WEB_URL：可选，设置 gerrit.config 中的 gerrit.canonicalWebUrl，默认值为 http://<镜像主机名>。
• HTTPD_LISTEN_URL：可选，覆盖 gerrit.config 中的 httpd.listenUrl 参数。

生产环境使用

生产环境需注意：使用高性能外部存储（优于 Docker 内部 AUFS）、独立配置目录（便于变更追踪），并配置外部认证（如 LDAP）。

示例：集成 OpenLDAP 的 docker-compose 配置

假设外部目录 /external/gerrit 已存在，以下是完整配置（含 OpenLDAP 和 PhpLdapAdmin）：

docker-compose.yaml

CODE_TOKEN_6

gerrit.config（位于 /external/gerrit/etc/）

CODE_TOKEN_7

secure.config（位于 /external/gerrit/etc/，存储敏感信息）

CODE_TOKEN_8

初始化 Gerrit 数据

外部文件系统需通过 gerrit.war 初始化（创建 All-Projects、All-Users 仓库及系统组 UUID）：

步骤 1：执行初始化

1. 取消 docker-compose.yaml 中 gerrit 服务的 command: init 注释。
2. 前台运行 Gerrit 容器：
   CODE_TOKEN_9
3. 等待输出 Initialized /var/gerrit 后，容器会自动退出。

步骤 2：后台启动服务

1. 注释 command: init，启动所有服务：
   CODE_TOKEN_10

通过 PhpLdapAdmin 管理 LDAP 用户

PhpLdapAdmin 可通过 `[***] 访问，用于管理 LDAP 用户。首次登录 Gerrit 的用户会被设为管理员，需提前在 LDAP 中创建管理员账户。

创建 Gerrit 管理员

1. 登录 PhpLdapAdmin：
   • 用户名：cn=admin,dc=example,dc=org
   • 密码：secret
2. 创建“Courier Mail Account”类型用户，示例信息：
   • 名：Gerrit
   • 姓：Admin
   • 通用名：Gerrit Admin
   • 用户 ID：gerritadmin
   • ***：gerritadmin@localdomain
   • 密码：secret

登录 Gerrit 管理员账户

访问 [***] gerritadmin和密码secret` 登录，完成初始化配置。

更多信息

• 查看 Gerrit 文档：`[***]
• Gerrit 官方主页：[***]