Opengrok 代码阅读工具

Opengrok 在线代码阅读工具,支持代码浏览,文件名搜索等功能。

API | Github | Docker API

最终效果:

image-20210901213553911

1. 安装使用

我是用Docker镜像的形式安装的,奉上官方API,根据API可以更高效的完成安装,这里也简单的做一下介绍。

1.1. 拉取docker镜像

1
docker pull opengrok/docker

1.2. 运行

1
docker run -d -v <path/to/your/src>:/opengrok/src -p 8080:8080 opengrok/docker:latest

容器为 OpenGrok 导出端口 8080。

安装到的卷/opengrok/src应包含您想要搜索的项目(在子目录中)。您可以使用常见的修订控制检出(git、svn 等),而 OpenGrok 将提供历史和责任信息。

运行成功后就可以直接访问到服务了。localhost:8080

2. 进阶

2.1. 目录

该图像包含以下目录:

目录 描述
/opengrok/etc 存储 Web 应用程序和索引器的配置
/opengrok/data 数据根 - 索引数据
/opengrok/src 源根 - 输入数据
/scripts 启动脚本和顶级配置。除非调试,否则不要覆盖。

2.2. 环境变量

Docker 环境变量 默认值 描述
SYNC_PERIOD_MINUTES 10 以分钟为单位的自动同步(即镜像 + 重新索引)的时间段。设置为0将禁用定期同步(容器启动后的同步仍将完成)。
INDEXER_OPT 空的 额外的选项传递给 OpenGrok Indexer。默认的索引器选项集是:--remote on -P -H -W。例如,-i d:vendor将从*/vendor/*索引中删除所有文件。您可以在https://github.com/oracle/opengrok/wiki/Python-scripts-transition-guide上检查索引器选项
NOMIRROR 空的 为避免镜像步骤,请将变量设置为非空值。
URL_ROOT / 覆盖 OpenGrok 应该运行的子 URL。
WORKERS 容器中的 CPU 数量 用于同步的工作人员数量(仅适用于启用项目的设置)
AVOID_PROJECTS 空的 在项目较少的配置中运行。设置为非空值会禁用项目。还禁用存储库同步。
REST_PORT 5000 简单 REST 应用程序侦听 GET 请求/reindex以触发手动重新索引的TCP 端口。
REST_TOKEN 没有任何 如果设置,REST 应用程序将需要此令牌作为不记名令牌以触发重新索引。
READONLY_CONFIG_FILE 没有任何 如果设置,配置将与此文件中的配置合并。这是在容器启动时运行的。
CHECK_INDEX 没有任何 如果设置,将首先检查索引的格式。如果索引与当前运行的版本不兼容,数据根将被清除并从头开始重新索引。

要为 指定环境变量docker run,请使用该-e选项,例如-e SYNC_PERIOD_MINUTES=30