{{< details >}}

  • Tier: 基础版, 专业版, 旗舰版
  • Offering: 私有化部署

{{< /details >}}

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

配置允许的导入源

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

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

启用项目导出

要启用项目及其数据的导出：

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

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

{{< details >}}

  • Status: Beta

{{< /details >}}

{{< history >}}

  • 引入于极狐GitLab 15.8。

{{< /history >}}

{{< alert type=”warning” >}}

在极狐GitLab 16.1 及更早版本中，您不应该使用直接传输与计划扫描执行策略。如果使用直接传输，首先升级到极狐GitLab 16.2，并确保在您执行的项目中启用了安全策略机器人。

{{< /alert >}}

{{< alert type=”warning” >}}

此功能处于 beta 阶段，可能会在没有通知的情况下更改。此功能尚未准备好用于生产环境。

{{< /alert >}}

通过直接传输迁移群组和项目默认情况下是禁用的。要启用通过直接传输迁移群组和项目：

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

同样的设置在 API 中作为 bulk_import_enabled 属性可用。

启用静默管理员导出

{{< history >}}

  • 引入于极狐GitLab 17.0，使用名为 export_audit_events 的功能标志。默认禁用。
  • 在极狐GitLab 17.1 中 GA。功能标志 export_audit_events 被移除。
  • 在极狐GitLab 17.1 中引入多文件导出下载的支持。

{{< /history >}}

启用静默管理员导出以防止实例管理员触发项目或群组文件导出或下载导出文件时生成审计事件。非管理员的导出仍会生成审计事件。

要启用静默管理员项目和群组文件导出：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 设置 > 常规，然后展开 导入和导出设置。
  3. 滚动到 管理员静默导出。
  4. 选中 启用 复选框。

允许贡献映射到管理员

{{< history >}}

  • 引入于极狐GitLab 17.5，使用名为 importer_user_mapping 的功能标志。默认禁用。
  • 在极狐GitLab 17.7 中，为 JihuLab.com 和私有化部署启用。

{{< /history >}}

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

要允许将导入的用户贡献映射到管理员：

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

最大导出大小

{{< history >}}

  • 引入于极狐GitLab 15.0。

{{< /history >}}

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

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

最大导入大小

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

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

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

如果选择的大小大于为 Web 服务器配置的值，可能会收到错误消息。请参阅故障排除部分了解更多详细信息。

对于 JihuLab.com 存储库大小限制，请阅读账户和限制设置。

导入的最大远程文件大小

{{< history >}}

  • 引入于极狐GitLab 16.3。

{{< /history >}}

默认情况下，从外部对象存储（例如 AWS）导入的最大远程文件大小为 10 GiB。

要修改此设置：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 设置 > 常规。
  3. 展开 导入和导出设置。
  4. 通过更改 最大导入远程文件大小 (MiB) 的值来增加或减少。设置为 0 表示不设置文件大小限制。

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

{{< history >}}

  • 引入于极狐GitLab 16.3。

{{< /history >}}

默认情况下，通过直接传输导入的最大下载文件大小为 5 GiB。

要修改此设置：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 设置 > 常规。
  3. 展开 导入和导出设置。
  4. 通过更改 直接传输最大下载文件大小 (MiB) 的值来增加或减少。设置为 0 表示不设置下载文件大小限制。

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

{{< history >}}

  • 引入于极狐GitLab 16.3。
  • 导入归档文件的最大解压缩文件大小字段在极狐GitLab 16.4 中从 最大解压缩大小做了重命名。

{{< /history >}}

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

当您导入压缩文件时，解压缩后的大小不能超过最大解压缩文件大小限制。如果解压缩后的大小超过配置的限制，将返回以下错误：

Decompressed archive size validation failed.

要修改此设置：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 设置 > 常规。
  3. 展开 导入和导出设置。
  4. 为 导入归档文件的最大解压缩文件大小 (MiB) 设置另一个值。

解压缩归档文件的超时时间

{{< history >}}

  • 引入于极狐GitLab 16.4。

{{< /history >}}

当您导入项目时，可以指定解压缩导入归档文件的最大超时时间。默认值为 210 秒。

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

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 设置 > 常规。
  3. 展开 导入和导出设置。
  4. 为 解压缩归档文件的超时时间 (秒) 设置另一个值。

最大同时导入作业数

{{< history >}}

  • 引入于极狐GitLab 16.11。

{{< /history >}}

您可以为以下项目指定同时执行的最大导入作业数：

在导入合并请求时不应用作业限制，因为有一个硬编码限制以避免服务器过载。

默认作业限制为：

  • GitHub 导入器为 1000。
  • Bitbucket 云和 Bitbucket 服务器导入器为 100。Bitbucket 导入器的默认限制较低，因为我们尚未确定一个好的默认限制。实例管理员应该尝试使用更高的限制。

要修改此设置：

  1. 在左侧边栏底部，选择 管理员。
  2. 选择 设置 > 常规。
  3. 展开 导入和导出设置。
  4. 为所需导入器的 最大同时导入作业数 设置另一个值。

最大同时批量导出作业数

{{< history >}}

  • 引入于极狐GitLab 17.6。

{{< /history >}}

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

默认值为 8 个作业，对应于最多 40 RPS 或 2000 用户的参考架构。如果您遇到 PG::QueryCanceled: ERROR: canceling statement due to statement timeout 错误或由于 Sidekiq 内存限制导致作业被中断，您可能需要减少这个数字。如果您有足够的资源，可以增加这个数字以处理更多并发导出作业。

要修改此设置，请发送一个 API 请求到 /api/v4/application/settings，使用 concurrent_relation_batch_export_limit。有关更多信息，请参阅应用设置 API。

故障排除

错误：帮助页面文档基本网址被阻止：执行超时

在启用诸如导入源之类的应用程序设置时，您可能会收到 帮助页面文档基本网址被阻止：执行超时 错误。要解决此错误：

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