从远端仓库拉取

移动到专业版于 13.9 版本。

您可以使用极狐GitLab 界面浏览仓库的内容和活动,即使它没有托管在极狐GitLab 上。创建拉取镜像,将分支、标签和提交从上游仓库复制到您的。

推送镜像不同,拉取镜像按计划从上游(远端)仓库检索更改。为防止镜像与上游仓库分叉,请勿将提交直接推送到下游镜像。改为将提交推送到上游仓库。远端仓库中的更改在以下情况被拉入极狐GitLab 仓库:

默认情况下,如果下游拉取镜像上的任何分支或标签与本地仓库不同,极狐GitLab 将停止更新该分支。这可以防止数据丢失。上游仓库中删除的分支和标签不会反映在下游仓库中。

note 对于从下游拉取镜像仓库中删除但仍在上游仓库中的项目,将在下一次拉取时恢复。例如:仅在镜像仓库中删除的分支,将在下一次拉取后重新出现。

拉取镜像如何工作

将 GitLab 仓库配置为拉取镜像后:

  1. 极狐GitLab 将仓库添加到队列中。
  2. 每分钟一次,Sidekiq cron 作业调度仓库镜像更新,基于:
    • 可用容量,由 Sidekiq 设置决定。
    • 队列中已有多少镜像需要更新。到期取决于上次更新仓库镜像的时间以及重试更新的次数。
  3. Sidekiq 可用于处理更新,镜像被更新。如果更新过程:
    • 成功:更新再次排队等待至少 30 分钟。
    • 失败:稍后再次尝试更新。在 14 次失败后,镜像被标记为 hard failure 并且不再排队等待更新。分支与其上游对应分支的分叉可能导致故障。为防止分支分叉,请在创建镜像时配置覆盖分叉的分支

配置拉取镜像

先决条件:

  1. 在左侧边栏中,选择 搜索或转到 并找到您的项目。
  2. 在左侧边栏中,选择 设置 > 仓库
  3. 展开 镜像仓库
  4. 输入 Git 仓库 URL。如果需要,请在 URL 中包含用户名:https://MYUSERNAME@github.com/GROUPNAME/PROJECTNAME.git
  5. 镜像方向,选择 拉取
  6. 验证方式 中,选择您的认证方式。
  7. 选择您需要的任何选项:
  8. 要保存配置,请选择 镜像仓库

覆盖分叉的分支

移动到专业版于 13.9 版本。

要始终使用远端版本更新本地分支,即使它们已从远端分支,请在创建镜像时选择 覆盖分叉分支

caution 对于镜像分支,启用此选项会导致本地更改丢失。

触发镜像更新的流水线

移动到专业版于 13.9 版本。

如果启用此选项,则在从远端仓库更新分支或标签时触发流水线。根据远端仓库的活动,这可能会大大增加 CI 运行程序的负载。仅当您知道它们可以处理负载时才启用此功能。CI 使用设置拉取镜像时分配的凭据。

使用 API 触发更新

移动到专业版于 13.9 版本。

拉取镜像使用轮询来检测上游添加的新分支和提交,通常是在几分钟之后。您可以使用 API 调用通知极狐GitLab,但最小拉取拉镜像限制的间隔仍然强制执行。

镜像时修复硬故障

移动到专业版于 13.9 版本。

连续 14 次重试失败后,镜像过程将被标记为硬故障并停止镜像尝试。此故障在以下任一情况下可见:

  • 项目的主仪表盘。
  • 拉取镜像设置页面。

要恢复项目镜像,强制更新