github

从Github导入

使用导入器，您可以将 GitHub 代码仓库导入 GitCode。

概览

导入了项目的以下方面：

• 仓库描述
• Git 存储库数据
• Issue
• 拉取请求
• Wiki
• 里程碑
• 标签
• Release
• 拉取请求评论
• 定期发布和请求注释

保留对拉取请求和问题的引用，并且每个导入的存储库都保持可见性级别，除非该可见性级别受到限制 ，在这种情况下，它默认为默认项目可见性。

创建 GitHub 个人访问令牌

以下是在 GitHub 中创建个人访问令牌（PTA）的步骤：

1. 请确保你已经成功注册了GitHub 账号，并登录了 GitHub
2. 访问 GitHub 的个人访问令牌（PAT）管理页，url 地址为Personal access tokens
3. 单击【Generate new token】 按钮，这一步会要求你输入 GitHub 账号密码，以确认是你本人在操作，输入你的 GitHub 密码即可
4. 填写你的个人访问令牌名称
5. 设置你的个人访问令牌有效期（ GitHub 访问令牌最大有效期为 1 年，建议设置 1 年）
6. 设置你的个人访问令牌的权限（建议勾选的权限包括Repo(全部),User(全部),write:packages,write:discussion,admin:repo_hook)
7. 以上设置完成后，单击页面下方的【Generate token】生成你的个人访问令牌
8. 在创建成功页中，GitHub 会显示你的个人访问令牌，是一串字符。请及时复制并保存你的个人访问令牌，离开或刷新页面后，将无法再查看你新建的个人访问令牌

你也可以参考 GitHub 官方的教程来创建一个你的 GitHub 个人访问令牌https://docs.github.com/cn/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token

实现原理

导入 Issue 和拉取请求时，导入程序会尝试在数据库中查找其 GitHub 作者和 指派人（请注意，拉取请求在 GitCode 中被称为"合并请求"）。

为了导入成功，在Github 项目导入前，至少需要项目中的每个作者和指派人都应该满足下列条件：

• 有一个 GitHub 帐户，其主要电子邮件地址与其 GitCode 帐户的电子邮件地址匹配。

如果在 GitCode 的数据库中未找到项目中引用的用户，则会将项目创建者（通常是启动导入的用户）设置为作者/指派人，但是对于该项目中 Issue 的评论，还是会提及到 Github 原作者。

如果导入项目的命名空间不存在，则导入项目时会创建新的命名空间/组织；如果名称空间已经被占用，则会将该项目导入至启动导入过程的用户的命名空间里，命名空间/代码仓库名称也可以由具有权限的用户进行编辑。

有关更多技术细节，您可以参考使用 GitHub 导入器开发人员文档。