opengrok搭建快餐教程2020
安裝tomcat
看這個中文版教程的大概在國内,大家下載下傳就找個鏡像會快一些,比如清華的鏡像:
https://mirrors.tuna.tsinghua.edu.cn/apache/tomcat下載下傳tar.gz包解壓之後,運作startup.sh,就可以在8080端口看到運作的tomcat的頁面,俗稱大貓頁:
編譯universal-ctags
首先下載下傳源代碼:
git clone https://github.com/universal-ctags/ctags
編譯需要autoconf和pkg-config兩個包的支援。可以通過apt或dnf,yum等包管理工具來安裝。
然後運作autoconf.sh,成功後生成configure腳本。
接着運作configure,最後運作make,大功告成。
下載下傳opengrok運作包
可以去
https://github.com/oracle/opengrok/releases/download找到目前最新的release:
wget -c https://github.com/oracle/opengrok/releases/download/1.3.6/opengrok-1.3.6.tar.gz
然後解壓到一個dist目錄裡吧,例:
tar -C ~/opengrok/dist --strip-components=1 -xzf opengrok-1.3.6.tar.gz
配置日志屬性
将我們剛才解壓的dist目錄下doc下的logging.properties複制到opengrok的etc目錄下:
cp ~/opengrok/dist/doc/logging.properties ~/opengrok/etc
建立索引
下面我們就可以正式建立索引啦,幾個主要參數如下:
- -Djava.util.logging.config.file: 配置日志屬性中講到過
- -jar: 下載下傳的opengrok.tar.gz中提供的opengrok.jar
- -c: 之前我們編譯好的ctags的執行路徑
- -s: 要建立索引的源代碼目錄
- -d: 生成索引資料的目錄
- -W: 配置檔案
例:
java -Djava.util.logging.config.file=~/opengrok/etc/logging.properties -jar ~/opengrok/dist/lib/opengrok.jar -c ~/opengrok/ctags/ctags -s ~/github -d ~/opengrok/data -H -P -S -G -W ~/opengrok/etc/configuration.xml
部署
首先安裝下腳本工具,在dist/tools下有個opengrok-tools.tar.gz,通過pip指令進 行安裝:
pip3 install ./opengrok-tools.tar.gz
然後運作剛安裝腳本中的opengrok-deploy将剛才生成的source.war部署到tomcat的webapps目錄下,例:
opengrok-deploy -c ~/opengrok/etc/configuration.xml ~/opengrok/dist/lib/source.war ~/opengrok/apache-tomcat-9.0.30/webapps
然後我們打開浏覽器,就可以檢視結果了。因為我是在docker裡運作的,将8080映射到了10080,大家可以用8080就好: