Sourcegraph

在私有化部署版上,此功能默认启用。要隐藏此功能,禁用功能标志 sourcegraph。在 SaaS 版上,仅适用于公开项目。

Sourcegraph 提供代码智能功能,集成到 UI 中。启用后,参与的项目会在这些代码视图中显示代码智能弹出窗口:

  • 合并请求差异
  • 代码提交差异
  • 文件查看

当访问这些视图之一时,将鼠标悬停在代码引用上,可以看到一个弹出窗口,其中包含:

  • 引用定义的详情。
  • 前往定义,前往引用定义的代码行。
  • 查找引用,前往配置的 Sourcegraph 实例,展示引用列表并高亮代码。

Set up for self-managed GitLab instances

先决条件:

  • 您必须配置并运行一个 Sourcegraph 实例,并将您的极狐GitLab 作为外部服务与之关联。
  • 如果您的 Sourcegraph 实例使用 HTTPS 连接到极狐GitLab,则您必须为您的 Sourcegraph 实例配置 HTTPS

在 Sourcegraph 中:

  1. 前往 站点管理 区域。
  2. 可选。配置您的极狐GitLab 外部服务。如果您的极狐GitLab 仓库已经能够在 Sourcegraph 中可查找了,您可以跳过此步。
  3. 您可以在您的 Sourcegraph 实例上通过运行测试查询来确认您可以从极狐GitLab 上查找您的仓库。
  4. 在您的 Sourcegraph 配置中,将您的极狐GitLab 实例 URL 添加到 corsOrigin 设置 中。

下一步,配置您的极狐GitLab 实例以连接到您的 Sourcegraph 实例。

配置极狐GitLab 实例的 Sourcegraph

先决条件:

  • 您必须是管理员。
  1. 在左侧导航栏底部,选择 管理员
  2. 在左侧边栏中,选择 设置 > 通用
  3. 展开 Sourcegraph 配置部分。
  4. 勾选 启用 Sourcegraph
  5. 可选。选择 在私有和内部项目上阻止
  6. 将 Sourcegraph URL 设置为您的 Sourcegraph 实例,例如 https://sourcegraph.example.com
  7. 选择 保存变更

Sourcegraph administration settings

在用户偏好设置中启用 Sourcegraph

私有化部署实例上的用户必须要配置他们的用户设置才能够使用 Sourcegraph 集成。

在 JihuLab.com 上,集成对所有的公开项目可用。暂时不支持私有项目。

先决条件:

  • 如果在私有化部署实例上,确保开启了 Sourcegraph。

要在您的极狐GitLab 用户偏好设置中启用此功能:

  1. 在右上角,选择您的头像。
  2. 选择 偏好设置
  3. 集成 部分,选中 Sourcegraph 下的复选框。
  4. 选择 保存更改

参考

故障排查

Sourcegraph 不工作

如果您在您的项目上启用了 Sourcegraph,但是它不工作,可能是 Sourcegraph 还没有对项目进行索引。您可以通过访问 https://sourcegraph.com/gitlab.com/<project-path> 来检查 Sourcegraph 是否对您的项目可用,将 <project-path> 替换为您极狐GitLab 项目的路径。