安装之前,先对Gerrit/OpenLDAP/Docker做一个简单说明:
Gerrit: 代码托管平台,类似与GitLab,也可用于Code Review。
OpenLDAP: Gerrit没有用户注册功能,需要借助于第三方工具来完成账号注册/登陆等功能,OpenLDAP是其中一种 方案,也可以基于OAuth/htpasswd来实现。
Docker: 虚拟化容器,可以快速完成软件安装部署,不对本地宿主机配置产生依赖。对Docker不了解的同学,可以移步🎉 Docker 简介和安装 - Docker 快速入门快速上手。
1. 安装Docker-desktop
参考https://www.cnblogs.com/bingo39/p/16864271.html安装docker desktop版本。
选中Enable 'docker-compose' CLI alias,开启docker-compose命令。
2. 目录&配置文件准备
2.1 创建目录
在正式安装Gerrit和openLDAP容器之前,需要为他们创建以下目录。
/mydata/gerrit/etc
/mydata/gerrit/git
/mydata/gerrit/db
/mydata/gerrit/index
/mydata/gerrit/cache
其中/mydata/指本地Gerrit数据存放的根目录,用户可以自行替换。这里路径会映射到容器内部,这样Gerrit产生的数据文件就可以保存在宿主机的目录中,避免因为删除容器而导致数据丢失。
2.2 准备配置文件
在/mydata/gerrit/etc目录下创建以下两个配置文件:
gerrit.config文件:
[gerrit]
basePath = git
canonicalWebUrl = http://192.168.1.186:8010/
serverId = f5be0f2d-1ffc-4972-bd83-ba153859b150
[index]
type = LUCENE
[auth]
type = ldap
gitBasicAuth = true
gitBasicAuthPolicy = HTTP
[ldap]
server = ldap://ldap
username = cn=admin,dc=example,dc=org
accountBase = dc=example,dc=org
accountPattern = (&(objectClass=person)(uid=${username}))
accountFullName = displayName
accountEmailAddress = mail
groupBase = dc=example,dc=org
[sendemail]
enable = true
smtpServer = smtp.163.com
smtpServerPort = 465
smtpEncryption = SSL
ss