Fork me on GitHub

使用GitLab Mirrors同步Git仓库

笔者需实现多个Git仓库数据的同步,大致是从一个远程的Git仓库同步代码到公司内部的GitLab仓库。经过调研,笔者将目光瞄准开源的GitLab Mirrors。

GitLab自带镜像功能,不过本文并未使用:https://gitlab.com/help/workflow/repository_mirroring.md

GitLab Mirrors功能比较强大,可实现各种格式向Git的镜像,例如:Bazaar, Git, Mercurial, Subversion。

GitLab Mirrors的GitHub地址:https://github.com/samrocketman/gitlab-mirrors ,有兴趣的小伙伴可前往详细了解。

下面笔者将步骤记录一下。为描述方便,笔者使用如下契约:

  • 使用GitHub模拟远程Git仓库;
  • 使用GitLab模拟公司内部的Git仓库。

下面将围绕如何将一个GitHub仓库同步GitLab展开。

1 安装Git

1
yum install git

2 安装GitLab Mirrors所需软件

1
2
3
4
5
yum install python-setuptools
git clone https://github.com/alexvh/python-gitlab3.git
cd python-gitlab3
git checkout v0.5.4
python setup.py install

笔者机器上执行如上命令即可。大家如果安装python-gitlab3后,执行gitmirror依然报错,可参考该文档安装其他软件https://github.com/samrocketman/gitlab-mirrors/blob/master/docs/prerequisites.md

3 创建GitLab管理员账户并创建Group

  • 登录GitLab
  • 创建一个用户
  • 为该用户赋予管理员权限。简单起见,笔者使用root 这个GitLab的内置账户。
  • 在GitLab创建一个Group

4 创建一个系统用户,并生成SSH key

1
2
3
adduser gitmirror # 创建用户gitmirror
su - gitmirror # 切换到用户gitmirror
ssh-keygen # 生成SSH key,一路输入Enter键即可

5 为GitLab(镜像仓库)、GitHub(原始仓库)配置免密码登录

找到~/.ssh/id_rsa.pub

1
more /home/gitmirror/.ssh/id_rsa.pub

将内容贴到GitLab以及GitHub,方法比较简单,登录后找到SSH key的选项,然后粘贴即可。

执行如下命令,确保SSH key添加成功

1
2
ssh -T git@github.com
ssh -T git@localhost

如配置无误,会看到xxxx Success xxxx 的文字。

6 设置private token

访问 http://localhost/profile/account (即:GitLab的账户设置地址),找到private token项,复制其中的private token值,贴到~/private_token 文件中。

1
2
3
4
su - gitmirror
cd ~
touch private_token
# 粘贴private token中的内容

7 创建本地仓库路径

GitLab Mirrors会将GitHub上的代码clone到本地,默认是~/repositories ,因此我们得创建该目录。

1
2
cd ~
mkdir repositories

8 配置GitLab Mirrors

下载gitlab-mirrors项目

1
2
3
4
git clone https://github.com/samrocketman/gitlab-mirrors.git
cd gitlab-mirrors
chmod 755 *.sh
cp config.sh.SAMPLE config.sh

修改config.sh文件,该文件中配置项非常多,主要修改的有如下几处:

1
2
3
4
5
6
7
8
9
10
11
# gitmirror所运行的用户
system_user="gitmirror"
# 你在gitlab上建立的group
gitlab_namespace="Mirrors"
# gitlab的地址
gitlab_url="http://localhost"
# gitlab的管理员账户
gitlab_user="root"

9 镜像仓库

  • 添加仓库同步配置:

    1
    2
    cd gitlab-mirrors
    ./add_mirror.sh --git --project-name test --mirror git@github.com:itmuch/test.git

    这样,就可以将github.com中的指定仓库,同步到GitLab中指定Group中的test 仓库中去。

  • 手动同步

    1
    ./git-mirrors.sh
  • 定时同步

    1
    @hourly /home/gitmirror/gitlab-mirrors/git-mirrors.sh

参考文档

github 或者gitlab 设置添加SSH, 避免每次提交重复输入用户名:http://www.cnblogs.com/wutianlong/p/5465391.html

使用gitlab-mirrors从其它版本库同步代码:http://www.jianshu.com/p/54bd32c4862b

GitLab Mirrors 官方文档:https://github.com/samrocketman/gitlab-mirrors/blob/master/docs/installation.md

评论系统未开启,无法评论!