0. 前言

​ 现如今，我们很多公司都会将代码托管在自建的 GitLab 仓库中，很适合团队协作。但随之而来的这种开源版本的工具在一定程度上存在缺陷，比如诗人 (opens new window)今天要折腾的 SourceGraph 这个工具，就是来解决开源版本 GitLab 不支持的全局检索功能。

1. 安装部署 SourceGraph

​ 部署参考链接 (opens new window)

1.1 安装部署

直接按照官方操作傻瓜式安装，以下安装是为了快速体验特性，官方推荐生产部署采用 docker-compose 或者直接部署在 k8s 中，参考 (opens new window)

docker run -d --publish 7080:7080 --publish 127.0.0.1:3370:3370 --rm --volume ~/.sourcegraph/config:/etc/sourcegraph --volume ~/.sourcegraph/data:/var/opt/sourcegraph sourcegraph/server:3.33.0

--publish就是我们大家习惯的暴露端口的-p哦

7080是访问sourceGraph服务端口，3370是Grafana的端口

1.2 配置 Nginx 代理

​ 配置完成后，我们需要配置 Nginx 来将其服务进行代理，当然也可以访问本机http://x.x.x.x:7080;

location  / {
        proxy_set_header session-name $http_session-name;
        proxy_set_header userId $http_userId;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_pass http://10.6.6.26:7080;
    }

1.3 访问页面

​ 访问如下代表成功，首次进入是可以注册一个管理员身份快速体验，按页面提示操作即可。

​

2. 配置 Sourcegraph 网站

2.1 配置仓库

入口：Site admin > Repositories > Manage code hosts

2.2 配置 GitLab 仓库

点击上图中GitLab Self-Managed，下图中的配置参考官网 (opens new window)，下面的代码 SourceGraph 本身提供给了我们，这点还是很不错的，因为他的官方文档写的很生硬；当我们点击了GitLab Self-Managed之后,会出现如下图中画圈的部分，你想要添加那种类型的仓库，都可以直接生成代码，完事后添加即可，等待其同步完成。

​ 创建 gitlab 的 token 参考链接 (opens new window)，建议授权范围设置为 read_user, read_api, read_repository

{
"url": "https://<你的gitlab域名>",
"token": "<access token>",
"projectQuery": [
 "projects?membership=true&archived=no"
]
}

若你配置了 GitLab 授权登录（诗人 (opens new window)下文即将介绍），希望查找的仓库权限能跟授权账号走。可以在仓库配置中加入 Enforce permissions (OAuth)

{
  "authorization": {
    "identityProvider": {
      "type": "oauth"
    }
  }
}

申明

原创文章eryajf，未经授权，严禁转载，侵权必究！此乃文中随机水印，敬请读者谅解。

Copyright 二丫讲梵 (opens new window) 版权所有

2.3 配置 GitLab 授权访问 SourceGraph

SourceGraph 支持与 GitLab 权限打通，这样我们就不需要自己维护用户规则，全部采用 GitLab 的权限，即使 GitLab 是通过 Ldap，且继承用户所用的的权限，所以在代码检索时请注意，只能搜索自己有权限的仓库。配置参考官网链接 (opens new window)，还支持很多种认证方式。

入口：Site admin > Configuration > Site configuration

2.3.1 配置 gitlab 的授权应用程序，

参考GitLab 授权链接 (opens new window)

提示

1. 在 GitLab 右上角选择你的头像
2. 选择 Settings （或是 Edit profile）
3. 在左侧边栏选择 Applications
4. 输入 Name，Redirect URI，Scopes(授权范围设置为 api、read_user)。Redirect URI 是用户授权回调的地址，形如：http://sgdev2.example.com/.auth/gitlab/callback,仅仅替换域名即可 点击保存，就能看到 Application ID 和 Secret。
5. 此处的小坑，诗人 (opens new window)是采用 nginx 代理的，所以我的 443 是在 nginx 上，真正的 sourceGraph 是没有 https 的，故回调 url 不要填写 https

如下图，便是诗人 (opens new window)配置好的 GitLab 的

然后，回到 sourcegraph 网站站点进行配置。

提示

1. 在你的 sourcegraph 站点的右上角选择你的头像
2. 选择 Site admin
3. 在左侧边栏选择 Site configuration
4. 点击 Add GitLab sign-in，会自动添加如下授权代码。

当然，此处 sourceGraph 也是有代码提示,如下图

{
  "auth.providers": [
    {
      // See https://docs.sourcegraph.com/admin/auth#gitlab for instructions
      "type": "gitlab",
      "displayName": "GitLab",
      "url": "<GitLab URL>",
      "clientID": "<client ID>",
      "clientSecret": "<client secret>"
    }
  ]
}

type 和 displayName 保持默认。<GitLab URL> 改为你的 GitLab 地址，<client ID> 改为之前获得的 Application ID，<client secret> 改为 Secret，保存即可。

此时你退出，再登录就会出现，GitLab 授权按钮。

3. 查询结果导出

​ sourceGraph 是支持查询结果导出的，支持 csv 插件，配置参考 (opens new window)

4. 小结

按理安装完 Sourcegraph，进行仓库配置后，站点就能正常投入使用了。关于用户授权，是诗人 (opens new window)经历一番探索的总结，为有此需求的人在阅读官方文档中即将陷入迷茫提供的一个提示。

温馨提示：

• 若是你通过 GitLab 授权管理用户，需确保网站管理员为代码仓库的管理员，这样能保证用户的搜索池全面。
• 免费版的 Sourcegraph 只能注册 10 个用户哦！
• 升级应该在 Sourcegraph 的连续次要版本之间进行。例如，如果您正在运行 Sourcegraph 3.1，并且想要升级到 3.3，则应该先升级到 3.2，再升级到 3.3。
• 查询语法请参考官方文档哦，查询语法 (opens new window)
• 当然如果您觉得页面查询不爽，source 官方也是只吃了命令行查询工具，什么版本的都支持，可操考其 github 进行配置，非常简单，诗人 (opens new window)懒得写了。诗人 (opens new window)平时喜欢用命令行，然后通过 jq 工具来处理。
  • 官网 api 查询，链接 (opens new window)
  • 客户端配置，链接 (opens new window)