项目导入和导出的故障排除

如果您在导入或导出时遇到问题，请使用 Rake 任务启用调试模式： 

# Import
IMPORT_DEBUG=true gitlab-rake "gitlab:import_export:import[root, group/subgroup, testingprojectimport, /path/to/file_to_import.tar.gz]"

# Export
EXPORT_DEBUG=true gitlab-rake "gitlab:import_export:export[root, group/subgroup, projectnametoexport, /tmp/export_file.tar.gz]"

然后，查看以下关于特定错误消息的详细信息。

Exception: undefined method 'name' for nil:NilClass

username 无效。

Exception: undefined method 'full_path' for nil:NilClass

namespace_path 不存在。例如，某个组或子组拼写错误或缺失，或者您在路径中指定了项目名称。任务只创建项目。如果您想将其导入到新的组或子组，请先创建它。

Exception: No such file or directory @ rb_sysopen - (filename)

在 archive_path 中指定的项目导出文件丢失。

Exception: Permission denied @ rb_sysopen - (filename)

git 用户无法访问指定的项目导出文件。

解决问题的方法：

  1. 将文件所有者设置为 git:git。
  2. 更改文件权限为 0400。
  3. 将文件移动到公共文件夹（例如 /tmp/）。

Name can contain only letters, digits, emoji ... 

Name can contain only letters, digits, emoji, '_', '.', '+', dashes, or spaces. It must start with a letter,
digit, emoji, or '_', and Path can contain only letters, digits, '_', '-', or '.'. It cannot start
with '-', end in '.git', or end in '.atom'.

在 project_path 中指定的项目名称因某些原因无效。只需将项目名称放入 project_path 中。例如，如果您提供子组的路径，则会因 / 不是项目名称中的有效字符而失败。

Name has already been taken and Path has already been taken

具有该名称的项目已存在。

Exception: Error importing repository into (namespace) - No space left on device

磁盘空间不足以完成导入。在导入过程中，tarball 会缓存到您配置的 shared_path 目录中。请验证磁盘是否有足够的空闲空间来容纳缓存的 tarball 和磁盘上的解压项目文件。

导入成功，显示 Total number of not imported relations: XX 消息

如果您收到 Total number of not imported relations: XX 消息，并且在导入期间没有创建议题，请检查 exceptions_json.log。您可能会看到类似 N is out of range for ActiveModel::Type::Integer with limit 4 bytes 的错误，其中 N 是超出 4 字节整数限制的整数。如果是这种情况，您可能会遇到议题的 relative_position 字段重平衡的问题。 

# 检查 relative_position 的当前最大值
Issue.where(project_id: Project.find(ID).root_namespace.all_projects).maximum(:relative_position)

# 运行重平衡过程并检查 relative_position 的最大值是否发生变化
Issues::RelativePositionRebalancingService.new(Project.find(ID).root_namespace.all_projects).execute
Issue.where(project_id: Project.find(ID).root_namespace.all_projects).maximum(:relative_position)

重复导入尝试并检查议题是否成功导入。

导入时 Gitaly 调用错误

如果您尝试将大型项目导入到开发环境中，Gitaly 可能会抛出关于调用过多或调用次数过多的错误。例如： 

Error importing repository into qa-perf-testing/gitlabhq - GitalyClient#call called 31 times from single request. Potential n+1?

此错误是由于开发环境设置的 n+1 调用限制。要解决此错误，请将 GITALY_DISABLE_REQUEST_LIMITS=1 设置为环境变量。然后重新启动您的开发环境并再次导入。