项目导入导出管理
极狐GitLab 提供与项目导入和导出相关的 Rake 任务。有关更多信息,请参阅:
项目导入状态
您可以通过项目导入/导出 API 查询导入。 如 API 文档中所述,查询可能会返回导入错误或异常。
导入/导出 rake 任务
可以使用以下命令检查极狐GitLab 导入/导出版本:
# Omnibus installations
sudo gitlab-rake gitlab:import_export:version
# Installations from source
bundle exec rake gitlab:import_export:version RAILS_ENV=production
可以使用以下命令列出要导出的数据库表的当前列表:
# Omnibus installations
sudo gitlab-rake gitlab:import_export:data
# Installations from source
bundle exec rake gitlab:import_export:data RAILS_ENV=production
注意以下事项:
- 仅当导入和导出极狐GitLab 实例的版本如版本历史记录中所述兼容时,才能进行导入。
-
必须启用项目导入选项:
- 在左侧边栏中,选择 搜索或转到。
- 选择 管理中心。
- 在左侧边栏中,选择 设置 > 通用。
- 展开 可见性和访问控制。
- 在 导入源 下,选中 项目导出启用 选项。
- 选择 保存更改。
- 导出存储在临时目录中,每 24 小时由特定 worker 删除。
使用 Rake 任务导入大型项目
我们可以简单地从终端运行这个脚本:
参数:
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
username |
string | yes | 用户名 |
namespace_path |
string | yes | 命名空间路径 |
project_path |
string | yes | 项目名 |
archive_path |
string | yes | 要导入的导出项目 tarball 的路径 |
bundle exec rake "gitlab:import_export:import[root, group/subgroup, testingprojectimport, /path/to/file.tar.gz]"
如果您正在运行 Linux 软件包安装,请运行以下 Rake 任务:
gitlab-rake "gitlab:import_export:import[root, group/subgroup, testingprojectimport, /path/to/file.tar.gz]"
使用 Rake 任务导出
您可以使用 Rake 任务导出大型项目。
参数:
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
username |
string | yes | 用户名 |
namespace_path |
string | yes | 命名空间路径 |
project_path |
string | yes | 项目名 |
archive_path |
string | yes | 用于存储导出项目 tarball 的文件路径 |
gitlab-rake "gitlab:import_export:export[username, namespace_path, project_path, archive_path]"
故障排除
如果您在导入/导出时遇到问题,您可以使用相同的 Rake 任务启用 debug 模式:
# 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]"