opengrok搭建

╰半橙微兮° 2022-07-14 02:15 196阅读 0赞

# 前序 #

OpenGrok是一个快速，便于使用的源码搜索引擎与对照引擎，它能够帮助我们快速的搜索、定位、对照代码树。一般常用于大型的项目中，比如Android系统源码。  
我也是刚来公司后才发现有这个东西的，在此自己也搭建一套，方便在家里也可以查看源码。因为是查看自己定制的系统源码所以要搭这个，如果只是查看AOSP的官方源码推荐一个网站：[http://androidxref.com/][http_androidxref.com]

# 环境 #

OS：Debian 8/Ubuntu 14.04及以上  
Web Server：tomcat8  
JDK：openjdk-8  
opengrok：0.12.1.6 (stable)

## 安装tomcat8 ##

在这里为了简单化，直接使用系统内仓库进行安装了。  
`$ sudo apt-get install tomcat8`

## 安装 openjdk-8 ##

`$ sudo apt-get install openjdk-8-jdk`

## 安装opengrok ##

这个需要从github下载了。  
在这里可以找到所有releases的版本  
[https://github.com/OpenGrok/OpenGrok/releases][https_github.com_OpenGrok_OpenGrok_releases]  
我们使用最新的稳定版：0.12.1.6 (stable)  
最好找一个分区空间较大的地方安装

$ wget https://github.com/OpenGrok/OpenGrok/files/467358/opengrok-0.12.1.6.tar.gz.zip
    
    可能是为了减小体积吧，压缩了2次，所以我们也需要解压2次
    $ unzip opengrok-0.12.1.6.tar.gz.zip
    $ tar zxvf opengrok-0.12.1.6.tar.gz

# 配置opengrok #

在oepngrok的安装目录中，也就是我们刚刚解压后的目录，新建src和data目录。  
**src**目录用于存放源码的链接  
**data**目录用于存放生成的索引文件。

## 创建源码链接 ##

因为可能在下载opengrok之前就已经下好了android源码， 由于源码太大，复制和移动都不现实，所以我们可以使用软链接的方式。当然也可以在索引的时候指定源码路径，不过那样不便于管理，我不喜欢那样。以下是我的源码路径，可以根据自己的来进行修改。

$ ln -s /home/lu/Android-src/AOSP-6.0 ~/data/opengrok-0.12.1.6/src/AOSP-6.0
    $ ln -s /home/lu/Android-src/cm13 ~/data/opengrok-0.12.1.6/src/cm13

## 配置tomcat8 ##

opengrok 0.12.1.6版本默认是只识别tomcat6和7的，所以我们需要修改一下配置文件使其搜索tomcat8，当然了也可以直接安装tomcat7，不过在这里我使用的是tomcat8，所以必须要修改配置了。  
编辑opengrok安装目录中的`bin/OpenGrok`文件：

$ vim ~/data/opengrok-0.12.1.6/bin/OpenGrok
    找到/var/lib/tomcat7/webapps和/var/lib/tomcat7
    将tomcat7改为tomcat8即可。
    
    更简单的方式是直接使用sed命令批量改就行了
    $ sed -i 's/tomcat7/tomcat8/g' ~/data/opengrok-0.12.1.6/bin/OpenGrok

## 配置opengrok实例路径 ##

默认opengrok实例路径是`/var/opengrok`当第一次进行索引的时候会在改目录中生成配置文件和log文件。默认源码目录src和data索引文件也是要放置在这里的。为了方便起见我们也可以将其改为opengrok的安装目录下面。  
编辑opengrok安装目录中的`bin/OpenGrok`文件：

$ vim ~/data/opengrok-0.12.1.6/bin/OpenGrok
    
    找到如下内容
    OPENGROK_INSTANCE_BASE="${OPENGROK_INSTANCE_BASE:-/var/opengrok}"
    将其改为
    OPENGROK_INSTANCE_BASE="${OPENGROK_INSTANCE_BASE:-/home/lu/data/opengrok-0.12.1.6}"
    即可

# 索引项目 #

opengrok已经配置完了。要对项目进行索引，我们还需要一个工具[Exuberant Ctags][]。

## 安装Exuberant Ctags ##

$ sudo apt-get install exuberant-ctags

## 开始索引 ##

进入opengrok的安装目录，执行以下命令即可开始索引：

$ bin/OpenGrok index

它会自动去找安装目录下面src目录中的项目源码，并且将其索引记录到data目录中。  
索引过程中我们可以通过安装目录中的`log/opengrok0.0.log`查看当前进度。

## 部署 ##

索引完成后，我们就可以部署到tomcat8中，然后在web页面进行查看了。  
执行以下命令开始部署，注意由于我们是通过`apt-get`安装的tomcat8，所以系统会自动创建**tomcat8**用户和组的。而我们如果是其他用户的话需要加sudo 权限。

$ sudo bin/OpenGrok deploy

还有记得启动tomcat哦，我的是debian 8所以可以用**systemd**来启动。  
`$ sudo systemctl start tomcat8`  
如果是ubuntu 14.04的话，可能还没有systemd，可以使用以下命令启动。  
`$ sudo service tomcat8 start`

# 搜索项目 #

部署成功后，我们就可以通过浏览器访问了。  
`http://server-ip:8080/source/`  
出现以下界面就表示已经成功。  
![opengrok][]

最后如果在公司源码经常改动的话，可以通过**crontab**定时  
`repo sync`然后也定时`~/data/opengrok-0.12.1.6/bin/OpenGrok update`更新一下索引即可。

# 总结 #

刚开始的时候从网上也找了一些资料，有很多太笼统了，有的又残缺不全。最后只能去看官方文档了，发现还是文档比较靠谱点。要养成看文档的习惯啊。在安装包中的**doc目录**下面讲的很清楚了。

[http_androidxref.com]: http://androidxref.com/
[https_github.com_OpenGrok_OpenGrok_releases]: https://github.com/OpenGrok/OpenGrok/releases
[Exuberant Ctags]: http://ctags.sourceforge.net/
[opengrok]: /images/20220714/cdaaee60bd2a4e58b74c40ce7bf7c945.png