Preparing to migrate data to your enterprise

生成迁移存档后，您可以将数据导入目标 GitHub Enterprise Server 实例。在将变更永久应用到目标实例之前，您需要检查变更，查看有无潜在的冲突。

本文内容

Preparing the migrated data for import to GitHub Enterprise Server
生成迁移冲突列表
检查迁移冲突
解决迁移冲突或设置自定义映射

Preparing the migrated data for import to GitHub Enterprise Server

使用 scp 命令将从源实例或组织生成的迁移存档复制到 GitHub Enterprise Server 目标：
```
$ scp -P 122 /path/to/archive/MIGRATION_GUID.tar.gz admin@hostname:/home/admin/
```
以站点管理员身份通过 SSH 连接到目标 GitHub Enterprise Server 实例。
```
$ ssh -p 122 admin@HOSTNAME
```
使用 ghe-migrator prepare 命令准备要在目标实例上导入的存档，并生成新的迁移 GUID 供您在后续步骤中使用：
```
ghe-migrator prepare /home/admin/MIGRATION_GUID.tar.gz
```
- 要开始新的导入尝试，请再次运行 ghe-migrator prepare 并获取新的迁移 GUID。
- 要指定迁移文件的暂存位置，请在命令行附加 --staging-path=/full/staging/path。默认值为 /data/user/tmp。

生成迁移冲突列表

使用包含迁移 GUID 的 ghe-migrator conflicts 命令生成一个 conflicts.csv 文件：
```
$ ghe-migrator conflicts -g MIGRATION_GUID > conflicts.csv
```
- If no conflicts are reported, you can safely import the data by following the steps in "Migrating data to your enterprise".
如果存在冲突，请使用 scp 命令将 conflicts.csv 复制到您的本地计算机：
```
$ scp -P 122 admin@hostname:conflicts.csv ~/Desktop
```
继续“解决迁移冲突或设置自定义映射”。

检查迁移冲突

使用文本编辑器或与 CSV 兼容的电子表格软件打开 conflicts.csv。
按照示例中的指导和下面的参考表检查 conflicts.csv 文件，确保导入时将发生正确的操作。

conflicts.csv 文件包含冲突的迁移映射和建议操作。迁移映射列出了数据的迁移来源和数据应用到目标的方式。

`model_name`	`source_url`	`target_url`	`recommended_action`
`用户`	`https://example-gh.source/octocat`	`https://example-gh.target/octocat`	`map`
`组织`	`https://example-gh.source/octo-org`	`https://example-gh.target/octo-org`	`map`
`仓库`	`https://example-gh.source/octo-org/widgets`	`https://example-gh.target/octo-org/widgets`	`rename`
`团队`	`https://example-gh.source/orgs/octo-org/teams/admins`	`https://example-gh.target/orgs/octo-org/teams/admins`	`合并`

conflicts.csv 中的每一行都提供了以下信息：

名称	Description
`model_name`	正在更改的数据的类型。
`source_url`	数据的源 URL。
`target_url`	数据的预期目标 URL。
`recommended_action`	导入数据时，将发生首选操作 `ghe-migrator`。

每个记录类型的可能映射

转移数据时，ghe-migrator 可以进行多种不同的映射操作：

`action`	描述	适用的模型
`import`	（默认）源中的数据将导入目标。	所有记录类型
`map`	源中的数据将被目标上的现有数据替换。	用户、组织和仓库
`rename`	源中的数据将重命名，然后复制到目标。	用户、组织和仓库
`map_or_rename`	如果存在目标，请映射到该目标。否则，请重命名导入的模型。	用户
`合并`	源中的数据将与目标中的现有数据合并。	团队

We strongly suggest you review the conflicts.csv file and use ghe-migrator audit to ensure that the proper actions are being taken. If everything looks good, you can continue to "Migrating data to your enterprise".

解决迁移冲突或设置自定义映射

如果您认为 ghe-migrator 将执行不正确的变更，可以更改 conflicts.csv 中的数据，进行修改。您可以更改 conflicts.csv 中的任意行。

例如，我们假设您注意到源中的 octocat 用户正在被映射到目标上的 octocat：

`model_name`	`source_url`	`target_url`	`recommended_action`
`用户`	`https://example-gh.source/octocat`	`https://example-gh.target/octocat`	`map`

您可以选择将用户映射到目标上的其他用户。假设您知道 octocat 在目标上应当是 monalisa。您可以更改 conflicts.csv 中的 target_url 列以指代 monalisa：

`model_name`	`source_url`	`target_url`	`recommended_action`
`用户`	`https://example-gh.source/octocat`	`https://example-gh.target/monalisa`	`map`

另外，如果您想在目标实例上将 octo-org/widgets 仓库重命名为 octo-org/amazing-widgets，请将 target_url 更改为 octo-org/amazing-widgets，以及将 recommend_action 更改为 rename：

`model_name`	`source_url`	`target_url`	`recommended_action`
`仓库`	`https://example-gh.source/octo-org/widgets`	`https://example-gh.target/octo-org/amazing-widgets`	`rename`

添加自定义映射

迁移过程中一个常见的情况是，迁移用户的用户名在目标上与在源上不同。

如果拥有源中的用户名列表和目标上的用户名列表，您可以通过自定义映射构建一个 CSV 文件，然后应用此文件，确保迁移结束时每个用户的用户名和内容都有正确的映射。

您可以使用 ghe-migrator audit 命令，快速生成应用自定义映射所需的迁移用户的 CSV 文件：

$ ghe-migrator audit -m user -g MIGRATION_GUID > users.csv

现在，您可以编辑该 CSV，并为您想要映射或重命名的每个用户输入新的 URL，然后根据需要将第四列更新为 map 或 rename。

例如，要在目标 https://example-gh.target 上将用户 octocat 重命名为 monalisa，您需要创建一个包含以下内容的行：

`model_name`	`source_url`	`target_url`	`state`
`用户`	`https://example-gh.source/octocat`	`https://example-gh.target/monalisa`	`rename`

可以使用相同的流程为支持自定义映射的每个记录创建映射。更多信息请参见记录的可能映射表。

应用修改的迁移数据

进行更改后，请使用 scp 命令将修改后的 conflicts.csv（或格式正确的任何其他映射 csv）应用到目标实例：
```
$ scp -P 122 ~/Desktop/conflicts.csv admin@hostname:/home/admin/
```
使用 ghe-migrator map 命令重新映射迁移数据，并传入修改后的 csv 文件的路径和迁移 GUID：
```
$ ghe-migrator map -i conflicts.csv  -g MIGRATION_GUID
```
如果 ghe-migrator map -i conflicts.csv -g MIGRATION_GUID 命令报告冲突仍然存在，请重新运行迁移冲突解决流程。