Anolis OS 8.8服务器采用docker容器方式搭建gerrit3.8.1服务

hunter00812023-07-27 9:24

采用docker容器方式搭建gerrit3.8.1服务

  • 一、选择管理帐户密码的方式
  • 二、部署gerrit服务
    • [1. 采用docker compose部署单服务的方式部分gerrit](#1. 采用docker compose部署单服务的方式部分gerrit)
      • [(1) docker-compose.yaml文件内容](#(1) docker-compose.yaml文件内容)
      • [(2) 在docker-compose.yaml文件所在目录调用下面命令先进行初始化操作](#(2) 在docker-compose.yaml文件所在目录调用下面命令先进行初始化操作)
    • [2. 在宿主机上部署httpd服务用于管理密码](#2. 在宿主机上部署httpd服务用于管理密码)
      • [(1) 安装运行httpd服务](#(1) 安装运行httpd服务)
      • [(2) 配置gerrit相关配置文件](#(2) 配置gerrit相关配置文件)
    • [3. 启动gerrit服务](#3. 启动gerrit服务)
    • [4. 配置和gitlab交互的密钥](#4. 配置和gitlab交互的密钥)
    • [5. 配置docker容器dns解析](#5. 配置docker容器dns解析)
  • 三、使用gerrit服务
    • [1. 在Gerrit创建一个空项目并同步GitLab数据](#1. 在Gerrit创建一个空项目并同步GitLab数据)
    • [2. 配置Grerrit与gitlab的同步](#2. 配置Grerrit与gitlab的同步)
    • [3. 配置gerrit用户权限及拉取代码等相关操作](#3. 配置gerrit用户权限及拉取代码等相关操作)

当前使用的gerrit服务还是2020年9月份搭建的，借着使用的gitlab升级的东风，顺便把gerrit也做一下升级，本以为过程会比较顺利，实际却是一波三折，下面记录一下相关过程，便于后续参考。

一、选择管理帐户密码的方式

在Docker Hub中gerrit的官方地址查看了相关说明文档，其推荐使用docker compose的方式运行服务，对应的docker-compose.yml文件样例如下：

yaml 复制代码 
version: '3'

services:
  gerrit:
    image: gerritcodereview/gerrit
    ports:
      - "29418:29418"
      - "80:8080"
    depends_on:
      - ldap
    volumes:
      - /external/gerrit/etc:/var/gerrit/etc
      - /external/gerrit/git:/var/gerrit/git
      - /external/gerrit/db:/var/gerrit/db
      - /external/gerrit/index:/var/gerrit/index
      - /external/gerrit/cache:/var/gerrit/cache
    environment:
      - CANONICAL_WEB_URL=http://localhost
    # command: init

  ldap:
    image: osixia/openldap
    ports:
      - "389:389"
      - "636:636"
    environment:
      - LDAP_ADMIN_PASSWORD=secret
    volumes:
      - /external/gerrit/ldap/var:/var/lib/ldap
      - /external/gerrit/ldap/etc:/etc/ldap/slapd.d

  ldap-admin:
    image: osixia/phpldapadmin
    ports:
      - "6443:443"
    environment:
      - PHPLDAPADMIN_LDAP_HOSTS=ldap

推荐采用OpenLDAP来管理用户的帐户密码，尝试着按照推荐的方式搭建了服务，在第一步"配置Gerrit的管理员账号"访问形如"https:xxx.xxx.xxx.xxx:6443"地址时页面一直报"重定向次数过多"的错误，定位尝试许久，未能解决问题。于是尝试直接使用官方展示的单gerrit服务容器方案，对应的docker-compose.yml文件样例如下：

yaml 复制代码 
version: '1'

services:
  gerrit:
      image: gerritcodereview/gerrit:3.8.1
    ports:
      - "29418:29418"
      - "80:8080"
    volumes:
      - /data/gerrit/etc:/var/gerrit/etc
      - /data/gerrit/git:/var/gerrit/git
      - /data/gerrit/db:/var/gerrit/db
      - /data/gerrit/index:/var/gerrit/index
      - /data/gerrit/cache:/var/gerrit/cache
    environment:
      - CANONICAL_WEB_URL=http://gerrit.example.com
    command: init

通过配置的域名可以访问"http://gerrit.example.com"，出现了登录页面，要求使用OpenID登录或者使用OpenLDAP生成的帐户密码访问，尝试了相应方式，未能成功，考虑到前面搭建的gerrit服务采用的就是在http请求那里进行登录验证的方式，也就不折腾了，直接走已经验证过的路，分别参考了代码审查服务gerrit搭建+httpd反向代理、前面自己写的"CentOS 7 搭建gerrit服务总结"以及看起来像是官方的说明文档，确定了整体思路，接下来就是具体实施了。

看起来像是官方说明的链接地址访问需要翻墙，这里直接将相关信息罗列如下，有需要可参考：

bash 复制代码 
HTTP Basic Authentication
When using HTTP authentication, Gerrit assumes that the servlet container or the frontend web server has performed all user authentication prior to handing the request off to Gerrit.

As a result of this assumption, Gerrit can assume that any and all requests have already been authenticated. The "Sign In" and "Sign Out" links are therefore not displayed in the web UI.

To enable this form of authentication:
  git config --file $site_path/etc/gerrit.config auth.type HTTP
  git config --file $site_path/etc/gerrit.config --unset auth.httpHeader
  git config --file $site_path/etc/gerrit.config auth.emailFormat '{0}@example.com'
The auth.type must always be HTTP, indicating the user identity will be obtained from the HTTP authorization data.

The auth.httpHeader must always be unset. If set to any value (including Authorization) then Gerrit won't correctly honor the standard Authorization HTTP header.

The auth.emailFormat field ('optional') sets the preferred email address during first login. Gerrit will replace {0} with the username, as obtained from the Authorization header. A format such as shown in the example would be typical, to add the domain name of the organization.

If Apache HTTPd is being used as the primary web server and the Apache server will be handling user authentication, a configuration such as the following is recommended to ensure Apache performs the authentication at the proper time:

  <Location "/login/">
    AuthType Basic
    AuthName "Gerrit Code Review"
    Require valid-user
    ...
  </Location>

二、部署gerrit服务

1. 采用docker compose部署单服务的方式部分gerrit

(1) docker-compose.yaml文件内容

实际采用的docker-compose.yaml文件样例如下：

yaml 复制代码 
version: '1'

services:
  gerrit:
      image: gerritcodereview/gerrit:3.8.1
      restart: always
    ports:
      - "29418:29418"
      - "8080:8080"
    volumes:
      - /data/gerrit/etc:/var/gerrit/etc
      - /data/gerrit/git:/var/gerrit/git
      - /data/gerrit/db:/var/gerrit/db
      - /data/gerrit/index:/var/gerrit/index
      - /data/gerrit/cache:/var/gerrit/cache
    environment:
      - CANONICAL_WEB_URL=http://gerrit.example.com
    command: init

新建文件内容可采用下面命令的形式简化操作：

bash 复制代码 
cat > /root/docker/gerrit/docker-compose.yml << EOF
version: '1'

services:
  gerrit:
      image: gerritcodereview/gerrit:3.8.1
      restart: always
    ...省略了文件内容，实际使用时按真实的来...
    command: init
EOF

(2) 在docker-compose.yaml文件所在目录调用下面命令先进行初始化操作

bash 复制代码 
docker compose up gerrit

2. 在宿主机上部署httpd服务用于管理密码

(1) 安装运行httpd服务

考虑到运行的gerrit服务容器中内部没有httpd服务，因此在宿主机上安装httpd服务并启动，同时也设置为自启动，在root帐户下需要执行的相关命令如下：

bash 复制代码 
yum -y install httpd
systemctl start httpd
systemctl enable httpd

(2) 配置gerrit相关配置文件

创建存放帐户密码的空文件：

bash 复制代码 
touch /etc/httpd/conf.d/passwd

生成用于gerrit跳转的httpd配置文件

bash 复制代码 
cat > /etc/httpd/conf.d/gerrit.conf << EOF
<VirtualHost gerrit.example.com:80>
   ServerName gerrit.example.com
   ProxyRequests Off
    ProxyVia Off
    ProxyPreserveHost On
    AllowEncodedSlashes On
 
    <Proxy *>
          Order deny,allow
          Allow from all
    </Proxy>
 
    <Location /login/>
        AuthType Basic
        AuthName "Gerrit Code Review"
        Require valid-user
        AuthBasicProvider file
        AuthUserFile /etc/httpd/conf.d/passwd
    </Location>
    ProxyPass / http://127.0.0.1:8080/ 
</VirtualHost>
EOF

增加用户（使用"-c"参数会创建文件，只是新增用户不需要该操作）：

bash 复制代码 
htpasswd -cb /etc/httpd/passwd admin 123456
htpasswd -b /etc/httpd/conf.d/passwd admin YourPassword
htpasswd -b /etc/httpd/conf.d/passwd zhangs YourPassword

更新配置文件gerrit.config（gerrit服务容器中对应地址为"/var/gerrit/etc/gerrit.config"，更新操作可直接在宿主机上相应文件操作即可）

样例如下：

bash 复制代码 
[gerrit]
        basePath = git
        canonicalWebUrl = http://gerrit.example.com
        serverId = f08520dc-9ea5-48b2-b49f-66d4fd2aad80
[container]
        javaOptions = "-Dflogger.backend_factory=com.google.common.flogger.backend.log4j.Log4jBackendFactory#getInstance"
        javaOptions = "-Dflogger.logging_context=com.google.gerrit.server.logging.LoggingContext#getInstance"
        user = gerrit
        javaHome = /usr/lib/jvm/java-11-openjdk-11.0.19.0.7-4.el9.alma.x86_64
        javaOptions = -Djava.security.egd=file:/dev/./urandom
        javaOptions = --add-opens java.base/java.net=ALL-UNNAMED
        javaOptions = --add-opens java.base/java.lang.invoke=ALL-UNNAMED
[index]
        type = lucene
[auth]
        type = HTTP
[receive]
        enableSignedPush = true
[sendemail]
        enable = true
        smtpServer = smtp.mxhichina.com
        smtpServerPort = 465
        smtpEncryption = SSL
        smtpUser = gerrit@example.com
        sslVerify = false
        from = CodeReview<gerrit@example.com>
[sshd]
        listenAddress = *:29418
[httpd]
        listenUrl = http://*:8080/
[cache]
        directory = cache

更新发送邮箱密码

调整容器中文件"/var/gerrit/etc/secure.config"中sendemail部分的smtpPass配置，可修改发送邮箱的密码。样例如下：

bash 复制代码 
[auth]
        registerEmailPrivateKey = albUUgKWNFRcCMVhsLkVg87lQddBcmcMkm4=
[sendemail]
        smtpPass = your@passwordhere

配置完毕之后执行下面命令重启httpd服务：

bash 复制代码 
systemctl restart httpd

3. 启动gerrit服务

将docker-compose.yaml文件中的"command: init"注释掉，更新文件中的version值为"2"，文件内容样例如下：

yaml 复制代码 
version: '2'

services:
  gerrit:
      image: gerritcodereview/gerrit:3.8.1
      restart: always
    ports:
      - "29418:29418"
      - "8080:8080"
    volumes:
      - /data/gerrit/etc:/var/gerrit/etc
      - /data/gerrit/git:/var/gerrit/git
      - /data/gerrit/db:/var/gerrit/db
      - /data/gerrit/index:/var/gerrit/index
      - /data/gerrit/cache:/var/gerrit/cache
    environment:
      - CANONICAL_WEB_URL=http://gerrit.example.com
    # command: init

再调用下面命令启动gerrit服务：

bash 复制代码 
docker compose up -d

4. 配置和gitlab交互的密钥

在容器中目录"/var/gerrit/etc/"下已经生成好了密钥对，可选择"ssh_host_ed25519_key.pub"配置到对应的gitlab帐户上，便于后续拉取代码。

使用下面命令进容器：

bash 复制代码 
sudo docker exec -it -u root gerrit-gerrit-1 bash

在容器里面执行下面命令将ssh key放到指定位置：

bash 复制代码 
cp /var/gerrit/etc/ssh_host_ed25519_key /var/gerrit/.ssh/id_ed25519

修改所有者信息：

bash 复制代码 
chown gerrit:gerrit /var/gerrit/.ssh/id_ed25519

5. 配置docker容器dns解析

如果需要用到指定的域名解析，可在宿主机上进行配置，修改daemon.json文件（保持其他内容不变，更新dns信息配置），查看内容命令如下：

bash 复制代码 
cat /etc/docker/daemon.json
{
  "dns": ["172.18.0.52", "172.18.0.70", "183.XX.XX.XX"]
}

更新完配置后，调用下面命令重启docker：

bash 复制代码 
systemctl daemon-reload
systemctl restart docker

要验证域名解析是否生效，可在容器中执行类似下面的命令验证：

bash 复制代码 
ping gitlab.example.com

三、使用gerrit服务

1. 在Gerrit创建一个空项目并同步GitLab数据

假设在gitlab上有一个项目testrepo，则进到gerrit网页在仓库那里相应创建一个testrepo项目。

使用下面命令进容器：

bash 复制代码 
sudo docker exec -it -u gerrit gerrit-gerrit-1 bash

进入到目录"/var/gerrit/git"下，执行下面命令删除自动创建的目录：

bash 复制代码 
cd /var/gerrit/git
rm -rf testrepo.git/

使用下面命令克隆gitlab代码：

git clone --bare git@gitlab.example.com:test/testrepo.git ./testrepo.git

2. 配置Grerrit与gitlab的同步

可在下面网址查看看插件状态：

http://gerrit.example.com/admin/plugins

使用下面命令生成replication.config文件（对应容器目录为"/var/gerrit/etc/"）：

bash 复制代码 
cd /var/gerrit/etc/
cat > replication.config << EOF
[remote "testrepo"]
projects = testrepo
url = git@gitlab.example.com:test/testrepo.git
push = +refs/heads/*:refs/heads/*
push = +refs/tags/*:refs/tags/*
push = +refs/changes/*:refs/changes/*
threads = 3
EOF

更新完replication.config文件后，在宿主机上docker-compose.yaml目录下使用下面的命令重启容器：

bash 复制代码 
docker compose restart

3. 配置gerrit用户权限及拉取代码等相关操作

用户权限的配置等相关使用请直接参考gerrit使用小结，在此就不赘述了。

参考链接：
docker-gerrit github网页

相关推荐
玖石书2 分钟前
docker 数据管理
docker·容器
shuxianshrng9 分钟前
大气网格化精细化监管监测系统
大数据·服务器·windows·经验分享
friklogff26 分钟前
【C#生态园】构建你的C#操作系统：框架选择与实践
服务器·开发语言·c#
TravisBytes32 分钟前
linux 系统是如何收发数据包
linux·运维·服务器
平头哥在等你2 小时前
《计算机网络名词解释》
服务器·网络·计算机网络
2420302 小时前
Docker笔记-容器数据卷
docker
德迅--文琪2 小时前
SCDN是服务器吗？SCDN防御服务器有什么特点?
运维·服务器
ice___Cpu2 小时前
Linux 基本使用和 web 程序部署 （ 8000 字 Linux 入门 ）
linux·运维·前端
z202305082 小时前
linux 之0号进程、1号进程、2号进程
linux·运维·服务器
秋已杰爱2 小时前
HTTP中的Cookie与Session
服务器·网络协议·http
热门推荐
01RAG 实践- Ollama+RagFlow 部署本地知识库02组基轨迹建模 GBTM的介绍与实现（Stata 或 R）032024年高教社杯数学建模国赛C题超详细解题思路分析04苍穹外卖面试总结05yolov8实战第五天——yolov8+ffmpg实时视频流检测并进行实时推流——（推流，保姆教学）06【2024数模国赛赛题思路公开】国赛B题思路丨附可运行代码丨无偿自提07软件工程从理论到实践客观题汇总(头歌第一章至第八章)08Coze扣子平台完整体验和实践（附国内和国际版对比）09【2024高教社杯全国大学生数学建模竞赛】B题 生产过程中的决策问题——解题思路 代码 论文10CCF-CSP认证考试 202406-3 文本分词 100分题解