在 GitHub 上准备源组织
-
确保您在源组织的仓库上具有所有者权限。
-
在 GitHub.com 上生成范围为
repo和admin:org的访问令牌。 -
为尽量减少停机，请创建要从源实例导出的仓库列表。 您可以使用每行列出一个仓库 URL 的文本文件一次性导出多个仓库。
导出组织的仓库
注意：复刻关系在迁移后不会持续。
要从 GitHub.com 导出仓库数据，请使用 Migrations API。
Migrations API 目前正处于预览阶段，这意味着端点和参数未来可能发生变化。 要访问 Migrations API，您必须在 Accept 标头中提供自定义媒体类型：application/vnd.github.wyandotte-preview+json。 以下示例包括自定义媒体类型。
生成迁移存档
注意： 锁定仓库会阻止对仓库的所有读取或写入。 您不能将新团队或协作者与锁定的仓库相关联。 如果您执行的试用版，则无需锁定仓库。 当您从正在使用的仓库迁移数据时，
GitHub 强烈建议锁定仓库。 更多信息请参阅“关于迁移”。
-
向您的组织的成员发送通知，告诉他们您将执行迁移。 导出可能需要数分钟的时间，具体取决于要导出的仓库数量。 包括导入的完整迁移可能需要数小时的时间，因此我们建议执行试运行，以便确定完整过程所需的时间。 更多信息请参阅“关于迁移”。
-
向迁移端点发送
POST请求，开始迁移。 您需要：- 身份验证的访问令牌。
- 想要迁移的仓库列表：
curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X POST \ -H "Accept: application/vnd.github.wyandotte-preview+json" \ -d'{"lock_repositories":true,"repositories":["orgname/reponame", "orgname/reponame"]}' \ https://api.github.com/orgs/orgname/migrations - 如果您想在迁移仓库之前先将其锁定，请确保
lock_repositories设为true。 强烈建议执行此操作。 - 您可以向端点传递
exclude_attachments: true，排除文件附件。 文件附件可能很大，可能不必要地胀大您的最终迁移存档。存档的最终大小必须小于 20 GB。
此请求将返回一个独一无二的
id，用于表示您的迁移。 后续调用 Migrations API 时需要使用此 id。 -
向迁移状态端点发送
GET请求以提取迁移的状态。 您需要：- 身份验证的访问令牌。
- 迁移的唯一
id：curl -H "Authorization: token GITHUB_ACCESS_TOKEN" \ -H "Accept: application/vnd.github.wyandotte-preview+json" \ https://api.github.com/orgs/orgname/migrations/id
迁移可能处于以下状态之一：
pending，表示迁移尚未开始。exporting，表示迁移正在进行。exported，表示迁移已成功完成。failed，表示迁移失败。
-
在导出您的迁移后，请向迁移下载端点发送
GET请求，下载迁移存档。 您需要：- 身份验证的访问令牌。
- 迁移的唯一
id：curl -H "Accept: application/vnd.github.wyandotte-preview+json" \ -u GITHUB_USERNAME:GITHUB_ACCESS_TOKEN \ -L -o migration_archive.tar.gz \ https://api.github.com/orgs/orgname/migrations/id/archive
-
迁移存档将在七天后自动删除。 如果您更喜欢提前删除，可以向迁移存档删除端点发送
DELETE请求。 您需要：- 身份验证的访问令牌。
- 迁移的唯一
id：curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \ -H "Accept: application/vnd.github.wyandotte-preview+json" \ https://api.github.com/orgs/orgname/migrations/id/archive
-
要将存档的迁移数据导入到 GitHub Enterprise Server 实例，请参阅“准备将数据迁移到企业”。