fabric8/gerrit

Docker Gerrit服务器镜像

镜像概述

该镜像基于Gerrit 2.11版本构建，提供Git项目的在线代码审查服务。它优化了现有Gerrit镜像的功能，支持自定义认证方式、自动向外部Git平台复制已审核代码，并可通过环境变量自动化创建用户和配置公钥，适用于团队协作和CI/CD流水线场景。

核心功能

1. 灵活认证: 支持OpenID、HTTP、LDAP、OAUTH等多种认证方式（通过AUTH_TYPE环境变量配置）。
2. 代码复制: 可将Gerrit中已审核通过的代码自动复制到GitHub、GitLab、Gogs等外部Git托管平台（需配置GIT_SERVER_*系列环境变量）。
3. 自动化用户管理: 通过GERRIT_ADMIN_*和GERRIT_ACCOUNTS环境变量，自动创建管理员和普通用户，并配置公钥。
4. 内置插件: 包含download-commands、delete-project、replication、add-user-plugin等实用插件。

使用场景

• 团队Git项目的代码审查流程搭建；
• CI/CD流水线中集成代码评审环节；
• 需要将Gerrit与外部Git仓库同步的开发场景；
• 自动化部署Gerrit服务器的需求。

配置说明

环境变量

• 认证配置: AUTH_TYPE（默认OpenID，可选DEVELOPMENT_BECOME_ANY_ACCOUNT、HTTP等）。
• 代码复制配置: GIT_SERVER_IP（Git服务器地址）、GIT_SERVER_PORT（端口）、GIT_SERVER_USER（用户名）、GIT_SERVER_PASSWORD（密码）等。
• 用户管理配置: GERRIT_ADMIN_USER（管理员用户名）、GERRIT_ADMIN_EMAIL（管理员***）、GERRIT_ACCOUNTS（分号分隔的用户列表，格式：<user_id>,<full_name>,<email>,<password>,<groups>）等。

卷挂载

• 主机SSH密钥卷: -v /本地路径/.ssh/id_rsa.pub:/root/.ssh/id_rsa.pub（公钥）和 -v /本地路径/.ssh/id_rsa:/root/.ssh/id_rsa（私钥）；
• Gerrit站点数据卷: -v /本地路径/gerrit-site:/home/gerrit/site（持久化Gerrit配置和数据）；
• 用户公钥卷: -v /本地路径/ssh-keys:/home/gerrit/ssh-keys（存放用户公钥文件）。

部署示例

基础运行（无额外功能）

bash
docker run -it -p 0.0.0.0:8080:8080 -p 127.0.0.1:29418:29418 --rm \
        --name gerrit docker.io/fabric8/gerrit:latest  

启用自动登录（演示用）

bash
docker run -it -p 0.0.0.0:8080:8080 -p 127.0.0.1:29418:29418 --rm \
        -e AUTH_TYPE='DEVELOPMENT_BECOME_ANY_ACCOUNT' \
        --name gerrit docker.io/fabric8/gerrit:latest

启用代码复制功能

bash
docker run -it -p 0.0.0.0:8080:8080 -p 127.0.0.1:29418:29418 --rm \
        -e AUTH_TYPE='DEVELOPMENT_BECOME_ANY_ACCOUNT' \
        -e GIT_SERVER_IP='gogs-http-service.default.local' \
        -e GIT_SERVER_PORT='80' \
        -e GIT_SERVER_USER=root \
        -e GIT_SERVER_PASSWORD=fabric01 \
        -e GIT_SERVER_PROJ_ROOT=root \        
        --name gerrit docker.io/fabric8/gerrit:latest

启用复制+自动创建管理员

bash
docker run -it -p 0.0.0.0:8080:8080 -p 127.0.0.1:29418:29418 --rm \
        -e AUTH_TYPE='DEVELOPMENT_BECOME_ANY_ACCOUNT' \
        -e GIT_SERVER_IP='gogs-http-service.default.local' \
        -e GIT_SERVER_PORT='80' \
        -e GIT_SERVER_USER=root \
        -e GIT_SERVER_PASSWORD=fabric01 \
        -e GIT_SERVER_PROJ_ROOT=root \      
        -e GERRIT_ADMIN_USER='admin' \
        -e GERRIT_ADMIN_EMAIL='***' \
        -e GERRIT_ADMIN_FULLNAME='Administrator' \
        -e GERRIT_ADMIN_PWD='mysecret' \          
        -e GERRIT_ADMIN_PRIVATE_KEY='/home/gerrit/ssh-keys/id_admin_rsa' \
        -e GERRIT_PUBLIC_KEYS_PATH='/home/gerrit/ssh-keys' \
        -v /本地路径/keys:/home/gerrit/ssh-keys \
        --name gerrit docker.io/fabric8/gerrit:latest