今天给大家介绍一个gitlab很高级也是非常有用的功能 - gitlab的mirroring，你可以将仓库镜像到外部或从外部镜像仓库过来，从而可以实现分支、标签和提交的自动同步。
文章目录
-
- [1. mirroring的实现方式](#1. mirroring的实现方式)
- [2. push mirroring](#2. push mirroring)
-
- [2.1 简介](#2.1 简介)
- [2.2 说明](#2.2 说明)
- [3. 配置推送镜像](#3. 配置推送镜像)
-
- [3.1 基于https的方式](#3.1 基于https的方式)
-
- [step1: 选择被推送的仓库所在的项目](#step1: 选择被推送的仓库所在的项目)
- [step2: 选择需要推送的仓库所在的项目：](#step2: 选择需要推送的仓库所在的项目：)
- [3.2 基于ssh方式](#3.2 基于ssh方式)
-
- [step1: 选择被推送的仓库所在的项目](#step1: 选择被推送的仓库所在的项目)
- [step2: 选择需要推送的仓库所在的项目](#step2: 选择需要推送的仓库所在的项目)
- [step3: 在上一步的基础上查看ssh公钥](#step3: 在上一步的基础上查看ssh公钥)
- [step4: 选择被推送的仓库所在的项目](#step4: 选择被推送的仓库所在的项目)
- [step5: 选择需要推送的仓库所在的项目](#step5: 选择需要推送的仓库所在的项目)
- [step6: 查看](#step6: 查看)
1. mirroring的实现方式
有以下几种mirroring的方法：
- 推送：将仓库从 GitLab 镜像到另一个位置。
- 拉取：将仓库从其他位置镜像到 GitLab 实例（专业版以上）。
- 双向镜像：彼此相互镜像，但可能会导致冲突。
2. push mirroring
- Gitlab 13.5引入，基于https支持lfs（大文件存储）
- 参考：push-mirroring
2.1 简介
-
推送镜像是一个下游存储库，用于镜像对上游存储库所做的提交。
-
推送镜像被动接收对上游存储库所做的提交的副本。
-
为防止镜像与上游存储库分流，请勿将提交直接推送到下游镜像。改为将提交推送到上游存储库。
2.2 说明
虽然拉取镜像（pull mirroring）会定期从上游存储库检索更新，但推送镜像（push mirror）仅在以下情况下接收更改：
- 提交被推送到上游 GitLab 存储库。
- 管理员强制更新镜像。
当更改推送到上游存储库时，推送镜像会收到它：
- 五分钟内。
- 在一分钟内，如果启用了仅镜像保护的分支。
如果是不同的分支，"镜像存储库"部分中会显示错误。
3. 配置推送镜像
3.1 基于https的方式
step1: 选择被推送的仓库所在的项目
如果需要通过某个用户来完成镜像推送，需要在协议后加上被推送仓库的username@,如https://renliting@docker.bdeet.top/test/aaa.git,对应的密码就是renliting用户的密码。改用户的权限至少是maintainer权限。
step2: 选择需要推送的仓库所在的项目：
Main menu -> Projects -> Settings > Repository -> **Mirroring repositories **-> input Git repository URL -Mirror direction(Push)-Authentication method(Password)-`Mirror repository
看到这种现象就说明已经ok了，当然你也可以测试下
3.2 基于ssh方式
参考链接：https://docs.gitlab.com/ee/user/project/repository/mirror/#get-your-ssh-public-key
step1: 选择被推送的仓库所在的项目
ssh的方式是将被推送的仓库的clone地址复制过来，然后需要url地址中的:改为/。如将git@docker.bdeet.top:mirror/ccc.git改为git@docker.bdeet.top/mirror/ccc.git
step2: 选择需要推送的仓库所在的项目
Main menu -> Projects -> Settings > Repository -> **Mirroring repositories **-> input Git repository URL -Mirror direction(Push)-Authentication method(SSH)-Mirror repository
step3: 在上一步的基础上查看ssh公钥
step4: 选择被推送的仓库所在的项目
Main menu -> Projects -> Settings > Repository -> **Mirroring repositories **-> Deploy keys
step5: 选择需要推送的仓库所在的项目
点击同步
显示已经同步完成
step6: 查看
可以发现，推送后两边的提交次数一致，说明推送成功。