当前位置：首页 > news >正文

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

news 来源：原创 2025/8/17 6:20:54

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

极狐GitLab 中文文档
极狐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.选择 保存更改。