市民服务中心网站建设,网站建设策划解决方案,申请主机网站,ppt素材免费网站采用docker容器方式搭建gerrit3.8.1服务 一、选择管理帐户密码的方式二、部署gerrit服务1. 采用docker compose部署单服务的方式部分gerrit(1) docker-compose.yaml文件内容(2) 在docker-compose.yaml文件所在目录调用下面命令先进行初始化操作 2. 在宿主机上部署httpd服务用于… 采用docker容器方式搭建gerrit3.8.1服务 一、选择管理帐户密码的方式二、部署gerrit服务1. 采用docker compose部署单服务的方式部分gerrit(1) docker-compose.yaml文件内容(2) 在docker-compose.yaml文件所在目录调用下面命令先进行初始化操作 2. 在宿主机上部署httpd服务用于管理密码(1) 安装运行httpd服务(2) 配置gerrit相关配置文件 3. 启动gerrit服务4. 配置和gitlab交互的密钥5. 配置docker容器dns解析 三、使用gerrit服务1. 在Gerrit创建一个空项目并同步GitLab数据2. 配置Grerrit与gitlab的同步3. 配置gerrit用户权限及拉取代码等相关操作 当前使用的gerrit服务还是2020年9月份搭建的借着使用的gitlab升级的东风顺便把gerrit也做一下升级本以为过程会比较顺利实际却是一波三折下面记录一下相关过程便于后续参考。 一、选择管理帐户密码的方式 在Docker Hub中gerrit的官方地址查看了相关说明文档其推荐使用docker compose的方式运行服务对应的docker-compose.yml文件样例如下
version: 3services:gerrit:image: gerritcodereview/gerritports:- 29418:29418- 80:8080depends_on:- ldapvolumes:- /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/cacheenvironment:- CANONICAL_WEB_URLhttp://localhost# command: initldap:image: osixia/openldapports:- 389:389- 636:636environment:- LDAP_ADMIN_PASSWORDsecretvolumes:- /external/gerrit/ldap/var:/var/lib/ldap- /external/gerrit/ldap/etc:/etc/ldap/slapd.dldap-admin:image: osixia/phpldapadminports:- 6443:443environment:- PHPLDAPADMIN_LDAP_HOSTSldap推荐采用OpenLDAP来管理用户的帐户密码尝试着按照推荐的方式搭建了服务在第一步“配置Gerrit的管理员账号”访问形如“https:xxx.xxx.xxx.xxx:6443”地址时页面一直报“重定向次数过多”的错误定位尝试许久未能解决问题。于是尝试直接使用官方展示的单gerrit服务容器方案对应的docker-compose.yml文件样例如下
version: 1services:gerrit:image: gerritcodereview/gerrit:3.8.1ports:- 29418:29418- 80:8080volumes:- /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/cacheenvironment:- CANONICAL_WEB_URLhttp://gerrit.example.comcommand: init通过配置的域名可以访问“http://gerrit.example.com”出现了登录页面要求使用OpenID登录或者使用OpenLDAP生成的帐户密码访问尝试了相应方式未能成功考虑到前面搭建的gerrit服务采用的就是在http请求那里进行登录验证的方式也就不折腾了直接走已经验证过的路分别参考了代码审查服务gerrit搭建httpd反向代理、前面自己写的“CentOS 7 搭建gerrit服务总结”以及看起来像是官方的说明文档确定了整体思路接下来就是具体实施了。 看起来像是官方说明的链接地址访问需要翻墙这里直接将相关信息罗列如下有需要可参考
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 HTTPgit config --file $site_path/etc/gerrit.config --unset auth.httpHeadergit 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 BasicAuthName Gerrit Code ReviewRequire valid-user.../Location二、部署gerrit服务
1. 采用docker compose部署单服务的方式部分gerrit
(1) docker-compose.yaml文件内容
实际采用的docker-compose.yaml文件样例如下
version: 1services:gerrit:image: gerritcodereview/gerrit:3.8.1restart: alwaysports:- 29418:29418- 8080:8080volumes:- /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/cacheenvironment:- CANONICAL_WEB_URLhttp://gerrit.example.comcommand: init新建文件内容可采用下面命令的形式简化操作
cat /root/docker/gerrit/docker-compose.yml EOF
version: 1services:gerrit:image: gerritcodereview/gerrit:3.8.1restart: always...省略了文件内容实际使用时按真实的来...command: init
EOF(2) 在docker-compose.yaml文件所在目录调用下面命令先进行初始化操作
docker compose up gerrit2. 在宿主机上部署httpd服务用于管理密码
(1) 安装运行httpd服务
考虑到运行的gerrit服务容器中内部没有httpd服务因此在宿主机上安装httpd服务并启动同时也设置为自启动在root帐户下需要执行的相关命令如下
yum -y install httpd
systemctl start httpd
systemctl enable httpd(2) 配置gerrit相关配置文件
创建存放帐户密码的空文件
touch /etc/httpd/conf.d/passwd生成用于gerrit跳转的httpd配置文件
cat /etc/httpd/conf.d/gerrit.conf EOF
VirtualHost gerrit.example.com:80ServerName gerrit.example.comProxyRequests OffProxyVia OffProxyPreserveHost OnAllowEncodedSlashes OnProxy *Order deny,allowAllow from all/ProxyLocation /login/AuthType BasicAuthName Gerrit Code ReviewRequire valid-userAuthBasicProvider fileAuthUserFile /etc/httpd/conf.d/passwd/LocationProxyPass / http://127.0.0.1:8080/
/VirtualHost
EOF增加用户使用-c参数会创建文件只是新增用户不需要该操作
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.configgerrit服务容器中对应地址为“/var/gerrit/etc/gerrit.config”更新操作可直接在宿主机上相应文件操作即可 样例如下
[gerrit]basePath gitcanonicalWebUrl http://gerrit.example.comserverId f08520dc-9ea5-48b2-b49f-66d4fd2aad80
[container]javaOptions -Dflogger.backend_factorycom.google.common.flogger.backend.log4j.Log4jBackendFactory#getInstancejavaOptions -Dflogger.logging_contextcom.google.gerrit.server.logging.LoggingContext#getInstanceuser gerritjavaHome /usr/lib/jvm/java-11-openjdk-11.0.19.0.7-4.el9.alma.x86_64javaOptions -Djava.security.egdfile:/dev/./urandomjavaOptions --add-opens java.base/java.netALL-UNNAMEDjavaOptions --add-opens java.base/java.lang.invokeALL-UNNAMED
[index]type lucene
[auth]type HTTP
[receive]enableSignedPush true
[sendemail]enable truesmtpServer smtp.mxhichina.comsmtpServerPort 465smtpEncryption SSLsmtpUser gerritexample.comsslVerify falsefrom CodeReviewgerritexample.com
[sshd]listenAddress *:29418
[httpd]listenUrl http://*:8080/
[cache]directory cache更新发送邮箱密码 调整容器中文件“/var/gerrit/etc/secure.config”中sendemail部分的smtpPass配置可修改发送邮箱的密码。样例如下
[auth]registerEmailPrivateKey albUUgKWNFRcCMVhsLkVg87lQddBcmcMkm4
[sendemail]smtpPass yourpasswordhere配置完毕之后执行下面命令重启httpd服务
systemctl restart httpd3. 启动gerrit服务
将docker-compose.yaml文件中的“command: init”注释掉更新文件中的version值为“2”文件内容样例如下
version: 2services:gerrit:image: gerritcodereview/gerrit:3.8.1restart: alwaysports:- 29418:29418- 8080:8080volumes:- /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/cacheenvironment:- CANONICAL_WEB_URLhttp://gerrit.example.com# command: init再调用下面命令启动gerrit服务
docker compose up -d4. 配置和gitlab交互的密钥
在容器中目录“/var/gerrit/etc/”下已经生成好了密钥对可选择“ssh_host_ed25519_key.pub”配置到对应的gitlab帐户上便于后续拉取代码。 使用下面命令进容器
sudo docker exec -it -u root gerrit-gerrit-1 bash在容器里面执行下面命令将ssh key放到指定位置
cp /var/gerrit/etc/ssh_host_ed25519_key /var/gerrit/.ssh/id_ed25519修改所有者信息
chown gerrit:gerrit /var/gerrit/.ssh/id_ed255195. 配置docker容器dns解析
如果需要用到指定的域名解析可在宿主机上进行配置修改daemon.json文件保持其他内容不变更新dns信息配置查看内容命令如下
cat /etc/docker/daemon.json
{dns: [172.18.0.52, 172.18.0.70, 183.XX.XX.XX]
}更新完配置后调用下面命令重启docker
systemctl daemon-reload
systemctl restart docker要验证域名解析是否生效可在容器中执行类似下面的命令验证
ping gitlab.example.com三、使用gerrit服务
1. 在Gerrit创建一个空项目并同步GitLab数据
假设在gitlab上有一个项目testrepo则进到gerrit网页在仓库那里相应创建一个testrepo项目。 使用下面命令进容器
sudo docker exec -it -u gerrit gerrit-gerrit-1 bash进入到目录“/var/gerrit/git”下执行下面命令删除自动创建的目录
cd /var/gerrit/git
rm -rf testrepo.git/使用下面命令克隆gitlab代码 git clone --bare gitgitlab.example.com:test/testrepo.git ./testrepo.git
2. 配置Grerrit与gitlab的同步
可在下面网址查看看插件状态 http://gerrit.example.com/admin/plugins 使用下面命令生成replication.config文件对应容器目录为“/var/gerrit/etc/”
cd /var/gerrit/etc/
cat replication.config EOF
[remote testrepo]
projects testrepo
url gitgitlab.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目录下使用下面的命令重启容器
docker compose restart3. 配置gerrit用户权限及拉取代码等相关操作
用户权限的配置等相关使用请直接参考gerrit使用小结在此就不赘述了。
参考链接 docker-gerrit github网页
