dubbo-go v3 版本 go module 踩坑记荐

dubbo-go v3 版本 go module 踩坑记荐

作者 | 董剑辉、盛傲飞
来源 | 阿里巴巴原生公众号

问题背景


该问题源于我们想对 dubbo-go 的 module path 做一次变更,使用 dubbo.apache.org/dubbo-go/v3 替换之前的 github.com/apache/dubbo-go

首先,我们做了路径映射,在 dubbo.apache.org 下放置了一个 dubbogo/v3 文件,内容如下:

<html>
<head>
<meta name="go-import" content="dubbo.apache.org/dubbo-g薄荷o/v3 git <https:自动//github.com/apache/dubbo-go>">
<meta name="go-source" content="dubbo.apache.org/d服务员英文ubbo-go/v3 git <https://github.com/apache/dubb闪付o-go/tree/3.0{/dir服务行业的服务理念}> <https://github.com/apache/dubbo-go/blob/3.0{/dir}/{file}#L{line}>">
<meta http-equiv="refresh" content="0; url=https://pkg.go.de自动v/dubbo.apache.boystownorg/dubbo-go/v3">
</head>
<body>
<p>Redirecting to <a href="https://blog.51cto.com/u_13778063/2836641/<ht版本的拼音tps://pkg.go.dev/dubbo.apache.Goorg/dubbo-go/v3>东西向洞韩剧2;">pkg.go.dev/dubbo.apache.自动连点器org/dubbo-原生质层go/v3</a>..东西.</p>
</body>
&原生质层lt;/html>


其次,我们修改了 go.mod 的 modu工程师证有几种le 和对应的所有 import,并修改了所有子模块引用 dubbo-go 使用的 module 路径。

问题分析东西向洞2


在做完上述的修改后,我们提 PR 时,发现 CI 失败,经过服务器进一步的日志原生质层排查,我们确定是 CI 在跑集成测试时发生了错误,具体的错误提示信息如云倾北冥夜煊免费阅读下:

dubbo-go v3 版本 go module 踩坑记荐

这一段的执行逻辑是作者唐公子希望利用 docker 对 dubbo-go 中的集成测试内容构建镜像,并启动容器进行测试,该镜像打包所用的 Dockerfile 路径在 gith自动连点器ub.com/apache/dubbo-go/test/integrate/dubbo/go-server 目录下自动挡,对照错误日阿里巴巴云电脑官网志的 STEP 标识,我们可以定位到具体错误发生下面的两个步骤:

# ...
# STEP 9
RUN test ${PR_ORIGIN_REPO}自动挡车档位介绍 && go mod edit -replace=dubbo.apache.org/dubbo-go/v3=github.com/{PR_ORIGIN_REPO}@${PR_ORIGIN_CO阿里巴巴云客服工资MM版本答案ITID} || go get -u dubbo.apache.org枸杞/dubbo-go/v3@develop
# ...
# STEP 11
RUN go mod tidy && go install github.com/apache/dubbo-go/test/integrate/dubbo/go-server


在 STEP 9 中,我们使用 go mod edit -replace 替换了 dubbogo 的依赖路径,将其替换为发起 PR 请求的仓地址和 comboss直聘mit id。在此基础上,当镜像构建跑到 STEP11 ,尝试使用 go原生 mod tidy 拉包时发生了错误。

回过头查看错误日志,我们可以发现:

dubbo-go v3 版本 go module 踩坑记荐

由于我们只指定了 commit id,因此在版本英文 go m自动od 实际运行过程中,它会为我们生成一个假定版本号(关于假定版本号的更多说明可以查云倾北冥夜煊免费阅读看本文最后的问题拓展),这个假定版本号抓取远自动精灵程仓的最新有效 tag 为 v1.4.1【注:此处远程仓为 github.com/Mulavar/dubbo-go,这是我自己的 dubbo-go 分支,该分支拉取 fork 的时间比较早,其最后 tag 是 v1.4dubbo是干什么的.1】,并自增为 v1.4.2,主版本是 v1。版本号自动精灵在先前,我们的 dubbogo m软件开发odule path 是声明为 dub默读小说b工程师职称o.apache.org/dubbogo/v3,主版本是 v3,这导致了 go工程师 mod edit -replace 前后的依赖主版本分别是 v3 和 v1 ,出现了不一致,实际拉取 dubbogo 依赖的时候出错。

问题解BO


在问题分析一节中我们定位到这个问题在镜像构建的 STEP 9,即:

# STEP 9
RUN test ${PR_OR自动挡汽车的正确驾驶步骤IGIN_REPO} && go mod edit -replace=dubbo.apache.org/dubbo-go/v3=github.com/{PR_ORIGIN_REPO}@${PR_O默读小说RIGIN_COMMITID} || go get -u dubbo.apache.org/dubbo-go/v3@develop


这一步,我末代皇帝们使用 go mod edit -replace将一个 v3 版本的 go module 替换成了一个 v1 版本的 module,导服务员工作内容致主版本不一致发生错误,因工程师英文此我们只需在替换依赖路径时指定替换后的 module 主版本龙一版本也为 v3 即可,我们在 go mod edit -repldubbo协议ace 后的模块依赖路径后也加上 v3自动连点器 后缀工程师的拼音如下所示。
版本的拼音
修改前:

go mod edit -replace=dubbo.apache.org/dubbo-go/v3=github.com/{PR_ORIGIN_REPO}@${PR_ORIGIN_COMMITID}

⇒ 修改后:

go m版本龙一od edit -replace=dubbo.apache.org/dubbo-go/v3=github.com狗狗币/${PR_ORIGIN_REPO自动精灵}/v3@${PR_ORIGIN_COMMITID}

修复该问题后我们提dubbo和zookeeper详解交代码查看 CI,在 STEP 8 打印的日志信息中,可以看到替换后的 dubbogo 路径多了 v3,并且在拉包的时候跟的版本号(v3.0.0-20210509140455-2574eab5ad0b)主版本同样是 v3,成功拉取了依赖。

dubbo-go v3 版本 go module 踩坑记荐

问题拓展

1.云南 Semantic Import Versioning


在我们使用 Go module原生s 去构建项目的依赖关系时,对 go 项目的依赖都需要声明我们所使用的版本号,考虑到每次发布新版本时,兼容一直是开发者最为重视和头痛的问题,因此 go 通过语义导入版本控制(Semantic Import Versioning)来制定版本号的标准,来确保每个开发者能够根据自己的项目需求指定使用的依赖版本。根据 go 的语义导入版本控制准则,版本号由三部分构成:

dubbo-go v3 版本 go module 踩坑记荐

注:上图及以上部分内容参考自《Go Modules 详解》一文。

其中 Major vers原生质体ion 表示这是一个新的大版本,甚至这个新版本可能和旧版本是不兼容的。

Minor version 则表示这是一个大版本中的modern迭代,主要用于新增 feature 时递增。

Patch version 则是粒度最细的版本更新,表示一些 bug 的修复。

而指定主版本则有两种方式,一种是服务英文如上的直接声云南明,另一种则是在项目路径的最后加上版本后缀,如 dub宫崎骏bogo 3.0 版本声明的 module 则是 dubbo.apache.org/dubbo-go/v3,其中 v3云南财经大学 就是mode一个主版本的声明。

2. pseudo-version


Go 在使用依赖时推崇我们指定明确的版本号,比如 dubbogo 的 go.mod 中声明的对 cloud.google.com/go 的依赖:

dubbo-go v3 版本 go module 踩坑记荐

但考虑到在某些场景工程师的拼音下,我们想要使用模块依赖的某个未发版的版本(该模块只有一个已知的 com博古mit id),如 dubbogo 声明的阿里巴巴云客服兼职是真的吗 github.com/Microsoft/go-winio 依赖,就可以使用一个假定版本号(pseudo-vers工程师的拼音ion)去替代真实的版本号。假定版本号的格式为:

// (1) vX.0.google0-yyyymmddhhmmss-abcdef123456
// (2) vX.Y.(Z+1)-0.yyyymmddhhmmss-abcdef1波组词23456
// (3) vX.Y.(Z+1)-0.yyyymmddhhmmss-abcdef123456+inco版本龙一mpatible
// (4) vX.Y.Zdubbo-pre.0.yyyymmddhhmmss-abcdef12东西的拼音3456
// (5) vX.Y.Z-pre.0.yyyym云南师范大学mddhhmmss-abcdef123456+incompatible


可以看到 pseudo-ver东西半球的分界线是sion 被短斜杠分为三部分,其中第一部分 X.Y.Z 与 4.1 节提到的一致,分别是 major ve云顶之弈rsionminor versionpatch ve作者的英文rsion,而第二部分是一个格式为 yyyymmddhhmmss 的时间戳,第三部分是一个 12 位的 commit ha默读小说sh,可以手动指定,如果没有,则由 go 自动生成。自动挡
狗狗币
关于 pseudo-version,g云边有个小卖部o 的生成规则如下:

  • 查询该项目对应主版本(若项目依赖路径没有显式的 v2/v云南财经大学3 后缀,则默认为 v1 版本)的最新 tag。
  • 有 tag 则使用最新 tag 递增 patch ver亳州天气sion。
  • 无 tag ,根据项目路径带的后缀版本号自动生成(如 v3 则自动生成一个 3.0.0 开头的 pseud工程师是做什么的o-version)。

遵循这个规则,回头看前文的工程师职称问题分析和问题解决,我们就可以明白为什么在一开始 dubbo-go 的 pseudo-version 是 v1.4.2,这正是因为 go 认为 replace 后的 dubb阿里巴巴云客服ogo 依赖主版本是 v1,去查找了该主版本下的最新 tag,并递增了 patch version亳州天气,从而导致前后主版本不一致,当我们对版本路径加上 v3 后,go 查找不到对应主版本下的 t宫颈癌ag,为我们自动生成了 v3.0.0,从而通过了 CI 。

3. Go 模块嵌套


和 Java 不同,go 其实是没枸杞有子模块概念的。即使有些自动精灵时候,我们会看到有个 repo 里有多个 Go modules,比如项目的根目录有一个 go.mod ,里面有些子目录原生家庭是什么意思里又有 go.mod 。

这在 Go modules 被称为嵌套模块,而非父子模块,即两个模块没有任何关系,是相互独立的

那什么时候才需要单 repo 多模块呢?一般来说,碰原生家庭对一个人的影响有哪些到以下两种情况我们才会考虑使用单 repo 多模块的开发形式。

  1. 某个嵌套模块变动非常频繁,需要经常发版。
  2. 当中的嵌原生家庭是什么意思套模块仅仅依赖某个固定版本的根模块。

两种情况其实本质都是两个模块之dubbo怎么读间没什么强的版本绑定关系,但是由于一些其他原因需要放在一个 rpeo 下,因此形成了单 repo 多模块的局面。

4. dubbogo软件工程专业 静态映射文件内容解析


dub软件开发bo-go 使用了静态文件映射的方式实现了模块重定向,静态文件的内容如下:

其中的核心部分是 meta 标签 go-importgo-source

<html>东西湖天气预报
<head>
<meta name="go-import" content="dubbo薄荷.apache.org/dubbo-工程师是做什么的go/v3 git <https://github.com/apache/dubbo-东西南北的英文go>">
<meta name="go-source" content="dubbo.apache.org/du龚俊bbo-go/v3 git <https://gi默读小说thub.com/apache/dubbo-go/tree/3.0{/dir}> <https://github.com/apache/d云闪付ubbo-go/blob/3.0{/dir}/{file}服务行业#L{line}>">
<meta http-equiv="refresh" content=dubbo服务调用失败"0;软件库 url=https://pkg.go.dev/dubbo.apache.org/dubbo-go/v3">
</head>
<body>
<p>Redirecting to <a href="https自动点击器://blog.51cto.com/u_13778063/2BO8狗狗币36641/<https://pkg.go.dev/dubbo.apache.org/dubbo-go/v3>">pkg.go.dev/dubbo.apachmodee.org/dubbo-go/v3</a>...<云南大学/p&dubbo面试题gt;
</body>
</html>

1)go-import


go-import 的作用,是告诉 go get 去哪儿可以工商银行找到源码,content 分为三部分:

  • dubbo.apach原生家庭e.org/dub软件bo-go/v3:这个项目的 module 声明。
  • git:使用的版本控制工具。
  • &lt;https://github.com/apache/dubbo-go&gt;:告诉 go get 这个项目应该去哪儿阿里巴巴云客服考试找源代码。

2)go-sourc云闪付e


go-source 的作用,则是给项目生成具体的 go doc(现为 pkg.go.dev ) 文服务员的礼貌礼仪培训内容档,一共有 4 部分,前两部分和 go-import 一样作者魏承泽全部小说,是该项目的 module 声明和版本控制工具,后两部分阿里巴巴云客服考试则分别起如下作用:

  • &lt;h作者的英文ttps://github.com/apache/du自动化专业bbo-go/tree/3.0{/dir}&gt;:声明该项目的源代码所在位置。
  • &lt;https://githubgoogle.codubbo和zookeeper详解m/apache/dubbo-go/blob/3.0{/dir}/{file}#L{line}&gt;:映射文档和代码,帮云顶之弈助我们在点击文档的目录树时,可以跳转到对应的具体内容。

比如在 https://pkg.go.dev/dubbo.apache.org/dubbo-godubbo是干什么的/v3 上,我们点击其中一个文件:

dubbo-go v3 版本 go module 踩坑记荐

就会跳转到对应文件对应的文档。

dubbo-go v3 版本 go module 踩坑记荐

欢迎对 apache/dubbo-go 项目有兴趣的同学搜索钉钉群号 31363295,加入阿里巴巴云电脑官网钉钉交流群!

参考资魔道祖师

  • 《The Go Blog — Usimodelng Go Modules》:https://blog.golang.org/using-go-modules
  • 《Go Modules Refe公积金rence》:https://golang.org/ref/mod
  • 《Go Module 如何发布 v2 及以上云顶之弈版本》:https://blog.原生质层cyeam.com/go/2019/03/12/go-version
  • 《Go Mo工程师报考条件du版本之子les 详解》:https://www.sulinehk.com/post/go-modules-details/

作者软件测试简介


董剑辉(github @Mulavar),刚从 浙江大学 VLIS工程师英文 实验室毕业,目前在任 猿辅导 服务端开发工程师。

盛傲飞(github @aofei),goproxy.cn 项目作者,曾给 go 源码【如 mod 工具】提交过很多 PR。