Help us learn about your current experience with the documentation. Take the survey.

使用直接传输时迁移的项目

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

使用直接传输方法时，许多项目会被迁移，但也有一些项目会被排除。

迁移的群组项目

迁移的群组项目取决于目标 GitLab 版本。要确定特定群组项目是否被迁移：

  1. 检查目标版本中所有版本的 groups/stage.rb 文件， 以及企业版的 groups/stage.rb 文件。 例如，对于版本 15.9：
  2. 检查目标版本中群组的 group/import_export.yml 文件。 例如，对于版本 15.9： https://gitlab.com/gitlab-org/gitlab/-/blob/15-9-stable-ee/lib/gitlab/import_export/group/import_export.yml。

其他群组项目不会被迁移。

迁移到目标 GitLab 实例的群组项目包括：

群组项目 引入于
Badges GitLab 13.11
Board lists GitLab 13.7
Boards GitLab 13.7
Epics 1 GitLab 13.7
Group labels 2 GitLab 13.9
Group milestones GitLab 13.10
Iteration cadences GitLab 15.4
Iterations GitLab 13.10
Members 3 GitLab 13.9
Namespace settings GitLab 14.10
Release milestones GitLab 15.0
Subgroups GitLab 13.7
Uploads GitLab 13.7
Wikis GitLab 14.6

注释：

  1. 状态和状态 ID 在 GitLab 13.7 中引入。 标签关联在 GitLab 13.12 中引入。 系统笔记元数据在 GitLab 14.0 中引入。 Epic 资源状态事件在 GitLab 15.4 中引入。
  2. 群组标签在导入过程中无法保留任何关联的标签优先级。 您必须在将相关项目迁移到目标实例后，手动重新设置这些标签的优先级。
  3. 参见 用户贡献和成员映射。

排除的项目

一些群组项目被排除在迁移之外，因为它们：

  • 可能包含敏感信息：
    • CI/CD 变量
    • 部署令牌
    • Webhooks
  • 不受支持：
    • 自定义字段
    • 迭代节奏设置
    • 待处理的成员邀请
    • 推送规则

迁移的项目

如果您在 选择要迁移的群组 时选择迁移项目，项目项目会随项目一起迁移。

迁移的项目项目取决于目标 GitLab 版本。要确定特定项目项目是否被迁移：

  1. 检查目标版本中所有版本的 projects/stage.rb 文件， 以及企业版的 projects/stage.rb 文件。 例如，对于版本 15.9：
  2. 检查目标版本中项目的 project/import_export.yml 文件。 例如，对于版本 15.9： https://gitlab.com/gitlab-org/gitlab/-/blob/15-9-stable-ee/lib/gitlab/import_export/project/import_export.yml。

其他项目项目不会被迁移。

如果您选择不随群组一起迁移项目，或者想要重试项目迁移，可以使用 API 启动仅项目的迁移。

迁移到目标 GitLab 实例的项目项目包括：

项目项目 引入于
Projects GitLab 14.4
Auto DevOps GitLab 14.6
Badges GitLab 14.6
Branches (including protected branches) 1 GitLab 14.7
CI Pipelines GitLab 14.6
Commit comments GitLab 15.10
Designs GitLab 15.1
Issues GitLab 14.4
Issue boards GitLab 14.4
Labels GitLab 14.4
LFS Objects GitLab 14.8
Members 2 GitLab 14.8
Merge requests GitLab 14.5
Push rules GitLab 14.6
Milestones GitLab 14.5
External pull requests GitLab 14.5
Pipeline history GitLab 14.6
Pipeline schedules GitLab 14.8
Project features GitLab 14.6
Releases GitLab 15.1
Release evidences GitLab 15.1
Repositories GitLab 14.4
Snippets GitLab 14.6
Settings GitLab 14.6
Uploads GitLab 14.5
Vulnerability reports 3 GitLab 17.7
Wikis GitLab 14.6

注释：

  1. 导入的分支遵循目标群组的 默认分支保护设置。 这些设置可能导致未受保护的分支被导入为受保护分支。
  2. 参见 用户贡献和成员映射。
  3. 漏洞报告迁移时不包含其状态。 更多信息，请参见 issue 512859。 关于迁移漏洞报告时的 ActiveRecord::RecordNotUnique 错误， 请参见 issue 509904。

问题相关项目

迁移到目标 GitLab 实例的问题相关项目包括：

问题相关项目 引入于
Issue iterations GitLab 15.4
Issue resource state events GitLab 15.4
Issue resource milestone events GitLab 15.4
Issue resource iteration events GitLab 15.4
Merge request URL references GitLab 15.6
Time tracking GitLab 14.4
Comments GitLab 14.4

合并请求相关项目

迁移到目标 GitLab 实例的合并请求相关项目包括：

合并请求相关项目 引入于
Multiple merge request assignees GitLab 15.3
Merge request reviewers GitLab 15.3
Merge request approvers GitLab 15.3
Merge request resource state events GitLab 15.4
Merge request resource milestone events GitLab 15.4
Issue URL references GitLab 15.6
Time tracking GitLab 14.5
Comments GitLab 14.5

设置相关项目

迁移到目标 GitLab 实例的设置相关项目包括：

设置相关项目 引入于
Avatar GitLab 14.6
Container expiration policy GitLab 14.6
Project properties GitLab 14.6
Service Desk GitLab 14.6

排除的项目

一些项目项目被排除在迁移之外，因为它们：

  • 可能包含敏感信息：
    • CI/CD 作业日志
    • CI/CD 变量
    • 容器镜像
    • 部署密钥
    • 部署令牌
    • 加密令牌
    • 作业产物
    • 管道调度变量
    • 管道触发器
    • Webhooks
  • 不受支持：

    • Agents

    • 容器注册表

    • 自定义字段

    • 环境

    • 功能标志

    • 基础设施注册表

    • 从 GitLab Self-Managed 迁移到 GitLab.com 或 GitLab Dedicated 时， 分支保护规则中的实例管理员

    • 关联问题

    • 合并请求审批规则

      与项目设置相关的审批规则会被导入。

    • 合并请求依赖

    • 包注册表

    • Pages 域名

    • 待处理的成员邀请

    • 远程镜像

  • 不包含可恢复的数据：
    • 没有差异或源信息的合并请求 （更多信息，请参见 issue 537943）