Opengrok 代码阅读工具

2023-07-17 17:58:25 浏览数 (1)

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

1. 安装使用

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

1.1. 拉取docker镜像

代码语言:javascript复制
docker pull opengrok/docker

1.2. 运行

代码语言:javascript复制
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

0 人点赞