让 Tapd 的源码关联功能支持 Gitee 平台

简介: Tapd 是腾讯提供的越来越完善的项目管理工具,Gitee 是国内相对比较稳的代码托管平台。

Tapd 是腾讯提供的越来越完善的项目管理工具,Gitee 是国内相对比较稳的代码托管平台。本文记录了让 Tapd 的源码关联功能支持 Gitee 平台的方法,及摸索过程中遇到的问题的解决步骤。

背景

想要使用 Tapd + Gitee 的组合来管理业余项目,但 Tapd 目前官方支持的代码托管平台只有 Gitlab、GitHub 和腾讯工蜂,并不能直接支持 Gitee,直觉上 Gitee 是基于 Gitlab 开发的,所以尝试在 Tapd 里开启了 Gitlab 服务,然后直接将 webhook 地址配置到 Gitee 项目里,却并不能生效。

求索

这种问题我应该肯定不是第一个遇到,于是在 Tapd 的论坛里搜索 Gitee 关键字,果然在帖子 https://www.tapd.cn/forum/view/67001 里找到了方案。

方案

方案的原理简单来说就是 Gitee 在触发 webhook 时,向目标网址发起的请求和 GitLab 很雷同,只是有个别 Header 的名字不一样,但缺失特定的 Header 信息后无法正常触发 Tapd 的源码关联,所以可以通过 Nginx 反向代理来将缺失的 Header 补全,然后将请求转发给 Tapd 即可。

方案示意图

图片

对比直接支持的 Gitlab 的示意:

图片

所以前提条件是你有一个可以在公网访问到的 Nginx 服务器,且可以自己修改配置。

网友介绍方案及原理的 GitHub 仓库:https://github.com/notzheng/Tapd-Git-Hooks

操作步骤

  1. 在 Tapd 项目里开启 Gitlab 服务;

  2. 在你可用的公网 Nginx 服务器的配置文件里添加一段配置:

  1. server {

  2. listen 80;

  3. server_name tapdhooks.yourdomain.com;

  4. location ~ ^/(\d+)/([a-z0-9]+) {

  5. proxy_set_header X-Gitlab-Event $http_X_Gitee_Event ;

  6. proxy_set_header X-Gitlab-Token $http_X_Gitee_Token ;

  7. proxy_pass https://hook.tapd.cn ;

  8. }

  9. }

  1. 将 tapdhooks.yourdomain.com 解析到该 Nginx 服务器 IP;

  2. 将替换过域名的 webhook 链接配置到 Gitee 项目里;

    比如原 webhook 链接:https://hook.tapd.cn/32198210/adcc961bc533c74a257ef96295812fa7

    https://hook.tapd.cn 替换成 http://tapdhook.yourdomain.com 得到新的链接

    http://tapdhooks.yourdomain.com/32198210/adcc961bc533c74a257ef96295812fa7

搞定!

小插曲

事情就是这么简单,但往往实操的时候不会这么顺利,会有些小插曲,比如我就遇到了。

如上配置之后,我向 Gitee push 代码却发现并没有在 Tapd 看到源码关联,在 Gitee 配置 webhook 的地方 test 了一下,报 502 bad gateway。

把 test 请求在 postman 里构造出来,然后使用 hook.tapd.cn 的原链接,请求是成功的,加上 Nginx 新增的 Header,也没有问题,但换回自己域名的链接就报 502 了。在 Nginx 服务器上将错误日志打印出来:

2019/09/12 15:51:25 [crit] 24721#24721: *287854 SSL_do_handshake() failed (SSL: error:1411B041:SSL routines:SSL3_GET_NEW_SESSION_TICKET:malloc failure) while SSL handshaking to upstream, client: 28.39.21.123, server: tapdhooks.yourdomain.com, request: "POST /32198210/adcc961bc533c74a257ef96295812fa7 HTTP/1.1", upstream: "https://119.29.122.86:443/32198210/adcc961bc533c74a257ef96295812fa7", host: "tapdhooks.yourdomain.com"

所以是 Nginx 向 https://hook.tapd.cn 链接发起请求时,SSL 握手错误了。

在网上搜了一些网友们的帖子后,得出的结论基本是因为客户端与服务端支持的 SSL protocol 版本不一致导致的,用工具查了一下 Tapd 服务器支持的 protocol 版本是 TLSv2,而我 Nginx 服务器的 OpenSSL 版本较低,可能不支持这个,于是先是升级了服务器上的 OpenSSL 的版本,然后通过重新编译升级了 Nginx 的 OpenSSL 版本,之后问题解决。这两步自己维护 Ngninx 服务器的同学应该不在话下,在此不再赘述,以下是我参考的链接:

  • 升级服务器 OpenSSL 版本:CentOS之——升级openssl为最新版

  • 升级 Nginx 的 OpenSSL 版本:nginx旧版本openssl升级

参考

  • 分享一个让源码关联支持Gogs/Gitee等平台的解决方案

  • Tapd Git Hooks

  • nginx旧版本openssl升级

  • CentOS之——升级openssl为最新版

[分享一个让源码关联支持Gogs/Gitee等平台的解决方案]:

https://www.tapd.cn/forum/view/67001

[Tapd Git Hooks]:

https://github.com/notzheng/Tapd-Git-Hooks

[nginx旧版本openssl升级]:

https://my.oschina.net/u/1449160/blog/220415

[CentOS之——升级openssl为最新版]:

https://blog.csdn.net/l1028386804/article/details/53165252

目录
相关文章
|
6月前
|
持续交付 项目管理 开发工具
【必备工具】gitee上传-保姆级教程
【必备工具】gitee上传-保姆级教程
|
存储 运维 安全
【运维知识高级篇】一篇文章带你搞懂GitHub基础操作!(注册用户+配置ssh-key+创建项目+创建存储库+拉取代码到本地+推送新代码到Github)
【运维知识高级篇】一篇文章带你搞懂GitHub基础操作!(注册用户+配置ssh-key+创建项目+创建存储库+拉取代码到本地+推送新代码到Github)
354 0
怎样在GitHub上建立仓库、以及怎样实现分支代码的合并。保姆级别的教程
这篇文章是一份详细的GitHub使用教程,介绍了如何在GitHub上创建仓库、创建分支、编辑和发布更改内容、发起拉取请求以及合并分支的操作步骤。
怎样在GitHub上建立仓库、以及怎样实现分支代码的合并。保姆级别的教程
|
5月前
|
监控 JavaScript Serverless
函数计算产品使用问题之如何部署一个未构建的Vue项目,并实现从Gitee仓库自动同步更新
函数计算产品作为一种事件驱动的全托管计算服务,让用户能够专注于业务逻辑的编写,而无需关心底层服务器的管理与运维。你可以有效地利用函数计算产品来支撑各类应用场景,从简单的数据处理到复杂的业务逻辑,实现快速、高效、低成本的云上部署与运维。以下是一些关于使用函数计算产品的合集和要点,帮助你更好地理解和应用这一服务。
|
5月前
|
开发工具 git
文本,vitepress如何配置社区账号,如何设置git或者某站的社区账号,这里如何进行配置
文本,vitepress如何配置社区账号,如何设置git或者某站的社区账号,这里如何进行配置
|
7月前
|
存储 安全 Serverless
在函数计算中,当您通过应用关联到 Gitee 仓库并部署代码时
在函数计算中,当您通过应用关联到 Gitee 仓库并部署代码时
392 6
|
Web App开发 JSON 前端开发
YApi 官网说明文档-接口操作
为方便和前端, 节省沟通成本, 编写接口文档非常有比较 使用过swagger, 觉得入侵性太大. POST又感觉和项目结合的不太紧密. 所以一直在寻找 新的接口阅读/生成/测试工具. 下面介绍一下YApi.
1797 0
YApi 官网说明文档-接口操作
|
数据可视化 JavaScript 开发工具
【全网最全面】VS Code使用Git可视化管理源代码详细教程
【全网最全面】VS Code使用Git可视化管理源代码详细教程
7399 0
|
Shell 网络安全 开发工具
【Git用法】如何将本地项目上传到码云,只需这几步,每个步骤都有图文
如何将本地项目上传到码云,只需这几步,每个步骤都有图文
1517 0
【Git用法】如何将本地项目上传到码云,只需这几步,每个步骤都有图文
|
网络安全 开发工具 git
2023年1月伊凡梳理如何快速安装git并且配置本地gitee账号权限方便拉代码
本文优雅草伊凡投稿一颗优雅草科技,欢迎其他朋友们来投稿(一定会详细署名)还是那个原因因为重装了因此git信息已经没有了,还是那个原因因为网上各类文章鱼龙混杂有好的有坏的,真正可用的其实还是不好找的,自己弄一遍也熟悉一遍现在开始。执行后敲三次回车,分别是在问保存到哪个文件,输入口令,请再次确认口令,都不管因此回车。此处需要去生成,很简单,上面第一个是我之前已经生成过的也就是本机,我先删掉。大意就是我之前因为用的公钥对应的不一样造成的,简单,执行一下下。得到这个返回提问就是成功!这样就是成功了,然后执行。
2023年1月伊凡梳理如何快速安装git并且配置本地gitee账号权限方便拉代码