Building Your Team-GitWeb源码仓储环境搭建

工欲善其事，必先利其器。

本文主要总结团队协助中，GitWeb源码仓储环境搭建。

下文将分docker环境以及单机环境分别说明。

简介

GitWeb是Git版本控制系统自带的一个基于Web的仓库浏览工具。它允许用户通过浏览器查看Git仓库中的内容、提交历史、分支信息等。

以下是GitWeb的一些主要特点和功能：

1. 仓库浏览：GitWeb提供了一个简单的Web界面，允许用户在浏览器中浏览Git仓库的内容，包括文件、目录结构和提交历史等。

2. 可视化提交历史：用户可以查看提交的详细信息，包括提交者、提交时间、提交注释等，以及分支和标签的信息。

3. 文件查看：可以通过GitWeb在浏览器中查看特定文件的内容，这对于快速查看代码变更或比较不同版本的文件很有用。

4. 链接和导航：GitWeb生成的页面通常包含链接，方便用户浏览不同的提交、分支和标签。

5. 简单配置：GitWeb本身配置简单，可以通过一些配置文件和选项进行自定义，以适应用户的需求。

尽管GitWeb提供了一个简单的方式来查看Git仓库，但相比其他更强大的Git仓库管理工具（比如GitLab、GitHub等），GitWeb的功能相对较为有限。它适用于快速查看仓库内容和提交历史，但在团队协作、代码审查等方面可能会有所不足。

Docker版安装

环境准备

Docker 环境安装

在Linux服务器上安装Docker环境，具体可以参考：https://docs.docker.com/engine/install/ubuntu/

开放端口号

#开放9012端口号 
firewall-cmd --zone=public --add-port=9012/tcp --permanent 
#重载防火墙规则 
sudo firewall-cmd --reload

gitweb工作目录

mkdir /data/platform/06_gitweb/workspace

安装配置

参考https://github.com/fraoustin/gitweb

获取gitweb镜像

 docker pull fraoustin/gitweb

运行gitweb

绑定配置

docker run \
   --name gitweb \
   -d \
   -u root \
   -p 9012:80 \
   -e "GITUSER=avit" -e "GITPASSWORD=gitweb@avit" \
   -v /data/platform/06_gitweb/workspace:/var/lib/git \
   --restart=always \
   fraoustin/gitweb

查看日志

docker logs -f gitweb

查看镜像与容器信息

docker images  # 查看镜像
docker ps -a  # 查看所有容器服务的状态
docker port gitweb  # 查看端口映射
docker inspect gitweb #查看容器的具体信息

登录及基础配置

登录Gitweb

Docker运行gitweb成功后，访问地址：http://ip:port，第一次登录需要输入管理员密码

内容同步

内容同步通过jenkins-job-dept.android.doc.wikisync定时触发。

本地路径映射

workspace -> /data/platform/B0_gituser/workspace/repositories/01-codes/sync/

单机版安装

环境说明

安装服务器：Ubuntu 18.04.5 LTS

安装

sudo apt-get install git git-core gitweb

配置git仓储路径

修改/etc/gitweb.conf

sudo gedit /etc/gitweb.conf


#修改git项目存放的文件夹:
# path to git projects (<project>.git)
#$projectroot = "/var/lib/git";
$projectroot = "/home/git/repositories";
...

开启cgi

sudo a2enmod cgi

安装主题

gitweb刚安装上很难看，可以安装漂亮一点的主题美化页面

开源主题：https://github.com/kogakure/gitweb-theme

在git服务器上将这个开源项目克隆下来，根据readme说明执行：

sudo ./setup -vi --install

访问

访问http://localhost/gitweb即可通过网页游览项目

本机默认/etc/apache2/sites-available/000-default.conf端口号为80

实际访问应该为

http://ip/gitweb

gerrit配置gitweb插件

编辑配置文件/home/gerrit/gerrit_site/etc/gerrit.config,新增gitweb选项

[gitweb]
        cgi = /usr/lib/cgi-bin/gitweb.cgi
        type = gitweb

重启gerrit服务

./home/gerrit/gerrit_site/bin/gerrit.sh restart

再次访问gerrit页面,在项目Repository Browser即可看下gitweb选项

参考文档

• 服务器上的-Git-GitWeb