前往小程序，Get更优阅读体验！
立即前往
文档建议反馈控制台
首页
学习
活动
专区
工具
TVP
最新优惠活动
文章/答案/技术大牛
发布
首页
学习
活动
专区
工具
TVP最新优惠活动
返回腾讯云官网
社区首页 >专栏 >GitLab Merge Request 的 merge 引用

GitLab Merge Request 的 merge 引用

作者头像
AlphaHinex
发布于 2024-07-26 16:49:43
270
发布于 2024-07-26 16:49:43
举报
文章被收录于专栏：周拱壹卒

merge 引用及用途

10.3 Git 内部原理 - Git 引用[1] 及 10.5 Git 内部原理 - 引用规范[2] 中介绍了 Git 的引用（references，或简写为 refs）及其规范，可在本地 Git 仓库的 .git/refs 路径下查看已经 fetch 到本地的引用文件。

当我们在 GitLab 中创建一个 MergeRequest 时，remote 仓库中会自动创建 refs/merge-requests/iid/head 和 refs/merge-requests/iid/merge 两个引用，分别对应 MR 源分支内容，以及 将 MR 源分支内容合并至目标分支后的内容。

当我们对这个 merge 引用进行持续集成时，就可以实现未雨绸缪的效果：

即使尚未合并 MR，持续集成检查和验证的，却相当于是将 MR 合并至目标分支之后的效果。

这样在出现问题时，只需继续在 MR 中进行修改即可，而不是将已经合并至目标分支的内容回滚之后再重新处理。

本地获取 merge 引用

增加 fetch 引用规范

.git/config 配置文件中可以指定多个用于获取操作的引用规范。

添加 merge 引用的方式为增加 +refs/merge-requests/*/merge:refs/remotes/origin/merge-requests/*/merge，如：

代码语言：javascript
复制
[remote "origin"]
    url = https://gitlab.com/AlphaHinex/merge-refs-test.git
    fetch = +refs/heads/*:refs/remotes/origin/*
    fetch = +refs/merge-requests/*/merge:refs/remotes/origin/merge-requests/*/merge

在 GitLab 上创建 MergeRequest 之后，可使用 fetch 命令获取 merge 引用，如：

代码语言：javascript
复制
$ git fetch origin
remote: Enumerating objects: 1, done.
remote: Counting objects: 100% (1/1), done.
remote: Total 1 (delta 0), reused 0 (delta 0), pack-reused 0 (from 0)
展开对象中: 100% (1/1), 248 字节 | 248.00 KiB/s, 完成.
来自 https://gitlab.com/AlphaHinex/merge-refs-test
 * [新引用]          refs/merge-requests/1/merge -> origin/merge-requests/1/merge

show-ref 查看引用列表

之后可通过 show-ref 查看引用及对应的 commit id：

代码语言：javascript
复制
$ git show-ref
dcaeb64e20196eda19b7f71b86287566d987ea56 refs/heads/main
8f8976a512437c13784586460556dffeef53c645 refs/heads/mr
dcaeb64e20196eda19b7f71b86287566d987ea56 refs/remotes/origin/HEAD
dcaeb64e20196eda19b7f71b86287566d987ea56 refs/remotes/origin/main
f03da17f11a905fcc4766c97f05de2fa8c78ecda refs/remotes/origin/merge-requests/1/merge
8f8976a512437c13784586460556dffeef53c645 refs/remotes/origin/mr

也可以将 fetch 配置为 +refs/merge-requests/*:refs/remotes/origin/merge-requests/*，同时获得 MR 的 head 和 merge 分支：

代码语言：javascript
复制
$ git fetch
来自 https://gitlab.com/AlphaHinex/merge-refs-test
 * [新引用]          refs/merge-requests/1/head -> origin/merge-requests/1/head
$ git show-ref
dcaeb64e20196eda19b7f71b86287566d987ea56 refs/heads/main
8f8976a512437c13784586460556dffeef53c645 refs/heads/mr
dcaeb64e20196eda19b7f71b86287566d987ea56 refs/remotes/origin/HEAD
dcaeb64e20196eda19b7f71b86287566d987ea56 refs/remotes/origin/main
8f8976a512437c13784586460556dffeef53c645 refs/remotes/origin/merge-requests/1/head
f03da17f11a905fcc4766c97f05de2fa8c78ecda refs/remotes/origin/merge-requests/1/merge
8f8976a512437c13784586460556dffeef53c645 refs/remotes/origin/mr

可以看到，共有三个不同的 commit id：

  1. dcaeb64e20196eda19b7f71b86287566d987ea56：对应本地及远程的 main 分支及 HEAD 引用
  2. 8f8976a512437c13784586460556dffeef53c645：对应本地及远程的 mr 分支，以及 merge-requests/1/head 引用
  3. f03da17f11a905fcc4766c97f05de2fa8c78ecda：对应远程的 merge-requests/1/merge 引用

左侧未显示完整的即为 merge-requests/1/merge 引用。

从本地和 GitLab 上的 main 分支及 mr 分支提交记录里可以找到前两个 commit id，而第三个 commit id 则是 GitLab 在远程仓库的 merge-requests/1/merge 分支上将 mr 分支合并至目标分支 main 自动创建的 commit 对应的 id。

为 merge 引用创建分支

代码语言：javascript
复制
$ git branch -a
* main
  mr
  remotes/origin/HEAD -> origin/main
  remotes/origin/main
  remotes/origin/merge-requests/1/head
  remotes/origin/merge-requests/1/merge
  remotes/origin/mr
代码语言：javascript
复制
$ git checkout merge-requests/1/merge
分支 'merge-requests/1/merge' 设置为跟踪来自 'origin' 的远程分支 'merge-requests/1/merge'。
切换到一个新分支 'merge-requests/1/merge'
代码语言：javascript
复制
$ git branch -a
  main
* merge-requests/1/merge
  mr
  remotes/origin/HEAD -> origin/main
  remotes/origin/main
  remotes/origin/merge-requests/1/head
  remotes/origin/merge-requests/1/merge
  remotes/origin/mr
代码语言：javascript
复制
$ git status
位于分支 merge-requests/1/merge
您的分支与上游分支 'origin/merge-requests/1/merge' 一致。

无文件要提交，干净的工作区

此时即可直接在本地的 merge-requests/1/merge 分支上审查 MR 合并后的代码状态。

merge 引用行为验证

以下内容在 GitLab Community Edition v16.8.1 版本，及在线版 GitLab Enterprise Edition 17.3.0-pre 453542d17ca[3] 中验证。

创建 MR 之前，是否会在远程库中出现 head/merge 分支

不会。

在 MR 分支上提交新 commit 时，merge 分支内容是否会同步变化？

会。但可能稍微有个延迟。

代码语言：javascript
复制
$ git checkout mr
切换到分支 'mr'
您的分支与上游分支 'origin/mr' 一致。
代码语言：javascript
复制
$ touch new-file-in-mr-branch
$ git add .
$ git commit -am "New commit in mr branch"
[mr 3436570] New commit in mr branch
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 new-file-in-mr-branch
$ git push origin mr
枚举对象中: 3, 完成.
对象计数中: 100% (3/3), 完成.
使用 8 个线程进行压缩
压缩对象中: 100% (2/2), 完成.
写入对象中: 100% (2/2), 306 字节 | 306.00 KiB/s, 完成.
总共 2（差异 0），复用 0（差异 0），包复用 0
remote:
remote: View merge request for mr:
remote:   https://gitlab.com/AlphaHinex/merge-refs-test/-/merge_requests/1
remote:
To https://gitlab.com/AlphaHinex/merge-refs-test.git
   8f8976a..3436570  mr -> mr

拉取远程库的 merge 引用：

代码语言：javascript
复制
$ git fetch origin
来自 https://gitlab.com/AlphaHinex/merge-refs-test
   8f8976a..3436570  refs/merge-requests/1/head -> origin/merge-requests/1/head

如果拉取时没有 merge 引用的变化，可稍等一会之后再试：

代码语言：javascript
复制
$ git fetch
remote: Enumerating objects: 1, done.
remote: Counting objects: 100% (1/1), done.
remote: Total 1 (delta 0), reused 0 (delta 0), pack-reused 0 (from 0)
展开对象中: 100% (1/1), 248 字节 | 248.00 KiB/s, 完成.
来自 https://gitlab.com/AlphaHinex/merge-refs-test
 + f03da17...b20a111 refs/merge-requests/1/merge -> origin/merge-requests/1/merge  (强制更新)

在目标分支上提交新 commit 时，merge 分支内容是否会同步变化？

也会，同样可能有个延迟。

代码语言：javascript
复制
$ git checkout main
代码语言：javascript
复制
$ touch new-file-in-main-branch
$ git add .
$ git commit -am "New commit in main branch"
[main 8a98bc0] New commit in main branch
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 new-file-in-main-branch
$ git push origin main
枚举对象中: 4, 完成.
对象计数中: 100% (4/4), 完成.
使用 8 个线程进行压缩
压缩对象中: 100% (2/2), 完成.
写入对象中: 100% (3/3), 299 字节 | 299.00 KiB/s, 完成.
总共 3（差异 0），复用 0（差异 0），包复用 0
To https://gitlab.com/AlphaHinex/merge-refs-test.git
   dcaeb64..8a98bc0  main -> main
代码语言：javascript
复制
$ git fetch origin
remote: Enumerating objects: 4, done.
remote: Counting objects: 100% (4/4), done.
remote: Compressing objects: 100% (2/2), done.
remote: Total 2 (delta 1), reused 0 (delta 0), pack-reused 0 (from 0)
展开对象中: 100% (2/2), 293 字节 | 146.00 KiB/s, 完成.
来自 https://gitlab.com/AlphaHinex/merge-refs-test
 + b20a111...2978ae6 refs/merge-requests/1/merge -> origin/merge-requests/1/merge  (强制更新)

MR 分支新 commit 与目标分支新 commit 存在冲突时，merge 分支内容是否会同步变化？

此时 merge 分支不再同步变化，后续 MR 分支上的新提交 commit 也不会同步到 merge 分支上，需要处理冲突之后，才能恢复同步。

MR 关闭之后，是否还会同步更新 merge 分支内容？

不会了，重新开启 MR 后会继续同步更新。

参考资料

[1]

10.3 Git 内部原理 - Git 引用: https://git-scm.com/book/zh/v2/Git-内部原理-Git-引用

[2]

10.5 Git 内部原理 - 引用规范: https://git-scm.com/book/zh/v2/Git-内部原理-引用规范

[3]

453542d17ca: https://gitlab.com/gitlab-org/gitlab/-/commits/453542d17ca

[4]

[Commit Status Publisher] Allow refs/merge-requests/* in gitlab support: https://youtrack.jetbrains.com/issue/TW-45099/Commit-Status-Publisher-Allow-refs-merge-requests-in-gitlab-support

[5]

TeamCity Trigger on Pull Request vs Trigger on Merge: https://stackoverflow.com/questions/38619518/teamcity-trigger-on-pull-request-vs-trigger-on-merge/49388182#49388182

[6]

6.3 GitHub - Maintaining a Project: https://git-scm.com/book/id/v2/GitHub-Maintaining-a-Project

[7]

Git refs merge vs head in pull request: https://stackoverflow.com/questions/63594658/git-refs-merge-vs-head-in-pull-request

[8]

Create merge refs for MRs (merge and squash methods): https://gitlab.com/gitlab-org/gitlab-foss/-/issues/47110

[9]

Consider using the merge URL on PR builds: https://github.com/readthedocs/readthedocs.org/issues/6958

[10]

Difference of refs/pull-requests//merge and refs/pull-requests//from: https://community.atlassian.com/t5/Bitbucket-questions/Difference-of-refs-pull-requests-lt-ID-gt-merge-and-refs-pull/qaq-p/772142

[11]

Use merge request HEAD ref for detached merge request pipelines: https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/25504

[12]

Able to push to /ref/merge-requests/*/head: https://gitlab.com/gitlab-org/gitlab/-/issues/215432

[13]

Merge requests API: https://docs.gitlab.com/ee/api/merge_requests.html

[14]

Gitlab 中文文档 - Merge requests API: https://www.bookstack.cn/read/gitlab-doc-zh/docs-337.md

[15]

Merge request pipelines: https://docs.gitlab.com/ee/ci/pipelines/merge_request_pipelines.html

[16]

Using Git refs to check out GitLab Merge Requests, from your local repo: https://www.jvt.me/posts/2019/01/19/git-ref-gitlab-merge-requests/

本文参与 腾讯云自媒体同步曝光计划，分享自微信公众号。
原始发表：2024-07-21，如有侵权请联系 cloudcommunity@tencent.com 删除
merge
request
对象
同步
gitlab

本文分享自 周拱壹卒 微信公众号，前往查看

如有侵权，请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ，欢迎热爱写作的你一起参与！

merge
request
对象
同步
gitlab
评论
登录后参与评论
0 条评论
热度
最新
登录 后参与评论
推荐阅读
LV.
文章
0
获赞
0
目录
  • merge 引用及用途
  • 本地获取 merge 引用
    • 增加 fetch 引用规范
      • show-ref 查看引用列表
      • 为 merge 引用创建分支
      • merge 引用行为验证
        • 创建 MR 之前，是否会在远程库中出现 head/merge 分支
          • 在 MR 分支上提交新 commit 时，merge 分支内容是否会同步变化？
            • 在目标分支上提交新 commit 时，merge 分支内容是否会同步变化？
              • MR 分支新 commit 与目标分支新 commit 存在冲突时，merge 分支内容是否会同步变化？
                • MR 关闭之后，是否还会同步更新 merge 分支内容？
                • 参考资料
                相关产品与服务
                持续集成
                CODING 持续集成（CODING Continuous Integration，CODING-CI）全面兼容 Jenkins 的持续集成服务，支持 Java、Python、NodeJS 等所有主流语言，并且支持 Docker 镜像的构建。图形化编排，高配集群多 Job 并行构建全面提速您的构建任务。支持主流的 Git 代码仓库，包括 CODING 代码托管、GitHub、GitLab 等。
                产品介绍产品文档
                领券

                腾讯云开发者

                扫码关注腾讯云开发者

                扫码关注腾讯云开发者

                领取腾讯云代金券

                热门产品

                热门推荐

                更多推荐

                Copyright © 2013 - 2024 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有 

                深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 深公网安备号 44030502008569

                腾讯云计算（北京）有限责任公司 京ICP证150476号 |  京ICP备11018762号 | 京公网安备号11010802020287

                问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档

                Copyright © 2013 - 2024 Tencent Cloud.

                All Rights Reserved. 腾讯云 版权所有

                登录 后参与评论