danger89/repo_mirror_pull

GitLab仓库拉取镜像同步 - Docker镜像 + GitLab定时流水线

这是一个实用的Docker镜像，可与https://docs.gitlab.com/ee/ci/pipelines/schedules.html结合使用，实现拉取远程仓库的同步功能。

通常，GitLab社区版（GitLab CE）仅支持通过push方向进行仓库镜像同步。本Docker镜像配合yaml文件和定时任务，允许您通过**pull方向**同步仓库！即使使用GitLab CE，也能免费获得“GitLab镜像拉取”功能。

Docker镜像

我们在流水线中使用的Docker镜像为：https://hub.docker.com/r/danger89/repo_mirror_pull（源码）

GitLab流水线配置

以下是GitLab定时流水线的yaml文件（.gitlab-ci.yml），无需修改文件内容，变量可在GitLab定时任务中配置：

yml
repo_pull_sync:
  image: docker.xuanyuan.run/danger89/repo_mirror_pull:latest
  rules:
    - if: '$CI_PIPELINE_SOURCE == "schedule"'
    - if: $REMOTE_URL
    - if: $REMOTE_BRANCH
    - if: $ACCESS_TOKEN
  before_script:
    - git config --global user.name "${GITLAB_USER_NAME}"
    - git config --global user.email "${GITLAB_USER_EMAIL}"
  script:
    - git checkout $CI_DEFAULT_BRANCH
    - git pull
    - git remote remove upstream || true
    - git remote add upstream $REMOTE_URL
    - git fetch upstream
    - git rebase upstream/$REMOTE_BRANCH
    - git push "https://${GITLAB_USER_LOGIN}:${ACCESS_TOKEN}@${CI_REPOSITORY_URL#*@}" "HEAD:${CI_DEFAULT_BRANCH}"

注意：若需使用git merge替代git rebase，可根据需求修改脚本。

创建GitLab定时任务

步骤1：生成项目访问令牌

1. 进入项目设置：Settings -> Access Tokens
2. 勾选"api"权限范围
3. 保存并记录生成的令牌（后续使用）

步骤2：配置定时任务

1. 进入CI/CD设置：CI/CD -> Schedules -> New schedule
2. 添加以下变量：
   • REMOTE_URL（示例：https://github.com/project/repo.git）
   • REMOTE_BRANCH（示例：master）
   • ACCESS_TOKEN（步骤1生成的令牌）
3. 保存任务并点击"Play"按钮测试执行
4. 任务将按设定时间自动同步远程仓库到GitLab CE