极狐GitLab 项目导入导出设置介绍?

发布于:2025-04-19 ⋅ 阅读:(18) ⋅ 点赞:(0)

极狐GitLab 是 GitLab 在中国的发行版,关于中文参考文档和资料有:

导入导出设置 (BASIC SELF)

导入和导出相关功能的设置。

配置允许的导入源

在从其他系统导入项目之前,必须为该系统启用导入源。

1.以具有管理员访问级别的用户身份登录极狐GitLab。
2.在左侧导航栏底部,选择 管理中心
3.选择 设置 > 通用
4.展开 导入和导出设置 部分。
5.选择每个允许的 导入源
6.选择 保存更改

启用项目导出

启用导出项目及其数据:

1.以具有管理员访问级别的用户身份登录极狐GitLab。
2.在左侧导航栏底部,选择 管理中心
3.选择 设置 > 通用
4.展开 导入和导出设置部分
5.滚动到 项目导出
6.选择 启用 复选框。
7.选择 保存更改

通过直接传输启用群组和项目的迁移

  • 引入于极狐GitLab 15.8。

WARNING:在极狐GitLab 16.1 或更早版本中,您不应该使用具有计划扫描执行策略的直接传输功能。如果使用直接传输,请先升级到极狐GitLab 16.2,并确保在您要执行策略的项目中启用安全策略机器人。

WARNING:此功能在 beta,可能会在没有通知的情况下发生更改。此功能并为生产就绪。

您可以使用 UI 通过直接传输来启用群组迁移。

要通过直接传输启用群组迁移:

1.以具有管理员访问级别的用户身份登录极狐GitLab。
2.在左侧导航栏底部,选择 管理中心
3.选择 设置 > 通用
4.展开 导入和导出设置 部分。
5.滚动到 允许通过直接传输迁移极狐GitLab 群组和项目。
6.选择 启用 复选框。
7.选择 保存更改

API 中的设置与 bulk_import_enabled 属性的设置相同。

开启静默管理导出

  • 自极狐GitLab 17.0 引入并使用名为 export_audit_events 的开关默认禁用。
  • 在极狐GitLab 17.1 GA。功能开关 export_audit_events 已移除。
  • 自极狐GitLab 17.1 引入文件导出下载。

档实例管理员触发了项目或群组文件导出或下载导出文件时,将生成审计事件。开启静默管理导出是为了阻止审计事件。非管理员导出依旧会生成审计事件。

要开启静默管理项目和群组文件导出:

1.在左侧导航栏底部,选择 管理中心
2.选择 设置 > 通用,然后展开 导入和导出设置
3.滚动到 Silent exports by admins。
4.选择 启用 勾选框。

允许贡献映射到管理员

  • 自极狐GitLab 17.5 引入并使用名为 importer_user_mapping 的开关。默认禁用。

允许映射导入的用户贡献到管理员。

如要开启此功能:

1.在左侧导航栏底部,选择 管理中心
2.选择 设置 > 通用,然后展开 导入和导出设置
3.滚动到 允许贡献映射到管理员
4.选择 启用 勾选框。

最大导出大小

  • 引入于极狐GitLab 15.0。

要修改极狐GitLab 中导出的最大文件大小:

1.在左侧导航栏底部,选择 管理中心
2.选择 设置 > 通用,然后展开 导入和导出设置
3.通过更改 最大导出大小 (MiB) 中的值来增加或减少。

最大导入大小

  • 从 50 MB 更改为无限制于极狐GitLab 13.8。

要修改极狐GitLab 中导入的最大文件大小:

1.在左侧导航栏底部,选择 管理中心
2.选择设置 > 通用
3.展开 导入和导出设置
4.通过更改 最大导入大小 (MiB) 中的值来增加或减少。

此设置仅适用于仓库从极狐GitLab 导出文件导入。

如果您选择的大小大于 Web 服务器的配置值,则可能会收到错误。有关更多详细信息,请参阅故障排除。

有关 JihuLab.com 仓库大小限制,请阅读账户和限制设置。

导入的最大远端文件大小

  • 引入于极狐GitLab 16.3。

您可以在极狐GitLab 中修改从外部对象存储(例如 AWS)导入的最大远端文件的大小。

要修改最大导入远端文件端大小:

1.在左侧导航栏底部,选择 管理中心
2.选择 设置 > 通用
3.展开 导入和导出设置
4.通过更改 最大导入远程文件大小 (MiB) 中的值来增加或减少。设置为 0 可设置无文件大小限制。

通过直接传输导入的最大下载文件大小

  • 引入于极狐GitLab 16.3。

您可以在极狐GitLab 中修改直接传输导入的最大下载文件大小。
要修改通过直接传输导入的最大下载文件大小:

1.在左侧导航栏底部,选择 管理中心
2.选择 设置 > 通用
3.展开 导入和导出设置
4.通过更改 直接传输最大下载文件大小 (MiB) 中的值来增加或减少。设置为 0 可设置无下载文件大小限制。

导入归档的最大解压文件大小

  • 引入于极狐GitLab 16.3。
  • 最大解压大小 重命名为 导入归档的最大解压文件大小 于极狐GitLab 16.4。

当您使用文件导出或直接传输导入项目时,您可以指定导入归档的最大解压文件大小。默认值为 25 GB。

导入压缩文件时,解压后的大小不能超过最大解压文件大小限制。如果解压后的大小超过配置的限制,则返回以下错误:

Decompressed archive size validation failed.

要修改极狐GitLab 中导入的最大解压文件大小:

1.在左侧导航栏底部,选择 管理中心
2.选择 设置 > 通用
3.展开 导入和导出设置
4.为 导入归档的最大解压缩文件大小 (MiB) 设置其他值。

解压归档文件超时

  • 引入于极狐GitLab 16.4。

当您导入项目时,您可以指定解压导入档案的最大超时时间。默认值为 210 秒。

要修改极狐GitLab 中导入的最大解压文件大小:

1.在左侧导航栏底部,选择 管理中心
2.选择 设置 > 通用
3.展开 导入和导出设置
4.为 解压归档文件的超时时间(秒) 设置其他值。

同时导入的最大作业数

  • 自极狐GitLab 16.11 引入。

您可以为以下导入器指定同时执行的最大导入作业数:

  • GitHub 导入器
  • Bitbucket Cloud 导入器
  • Bitbucket Server 导入器

当导入合并请求时,此作业限制并不生效,因为为了避免服务器过载,我们已经设置了硬编码限制。

默认的作业限制为:

  • GitHub 导入器,为1000。
  • 对 Bitbucket Cloud 和 Bitbucket Server 导入器,为 100。Bitbucket 导入器有一个较低的默认限制,因为我们还没有确定一个好的默认限制。私有化部署的管理员可以通过实验来测试一个较高的限制值。

要想修改此设置:

1.在左侧导航栏底部,选择 管理中心
2.选择 设置 > 通用
3.展开 导入和导出设置
4.将期望导入器的 同时导入的最大作业数 设置其他值。

同时批处理导出作业的最大值

  • 自极狐GitLab 17.6 引入。

直接迁移导出会消耗大量的资源。为了防止耗尽数据库或 Sidekiq 进程,管理员可以配置 concurrent_relation_batch_export_limit 设置。

默认值为 8 个作业,对应于最多 40 RPS 或 2,000 个用户的参考架构。

如果您遇到了 PG::QueryCanceled: ERROR: canceling statement due to statement timeout 错误或者由于 Sidekiq 内存限制而中断作业,您可以减少此数字。如果您有足够的资源,您可以增加此数字以处理更多的并发导出作业。

要修改此设置,使用 concurrent_relation_batch_export_limit 发送 API 请求到 /api/v4/application/settings。更多详情可以查看应用程序设置 API 。

故障排查

错误: Help page documentation base url is blocked: execution expired

当开启诸如导入源之类的应用程序设置时,可能会收到 Help page documentation base url is blocked: execution expired 错误。要解决此错误:

1.将 docs.gitlab.cn 或重定向帮助文档页面 URL添加到等候列表中。
2.选择 保存更改


网站公告

今日签到

点亮在社区的每一天
去签到