从Github导入
使用导入器,您可以将 GitHub 代码仓库导入 GitCode。
概览
导入了项目的以下方面:
- 仓库描述
- Git 存储库数据
- Issue
- 拉取请求
- Wiki
- 里程碑
- 标签
- Release
- 拉取请求评论
- 定期发布和请求注释
保留对拉取请求和问题的引用,并且每个导入的存储库都保持可见性级别,除非该可见性级别受到限制 ,在这种情况下,它默认为默认项目可见性。
创建 GitHub 个人访问令牌
以下是在 GitHub 中创建个人访问令牌(PTA)的步骤:
- 请确保你已经成功注册了 GitHub 账号,并登录了 GitHub
- 访问 GitHub 的个人访问令牌(PAT)管理页,url 地址为 Personal access tokens
- 单击【Generate new token】 按钮,这一步会要求你输入 GitHub 账号密码,以确认是你本人在操作,输入你的 GitHub 密码即可
- 填写你的个人访问令牌名称
- 设置你的个人访问令牌有效期( GitHub 访问令牌最大有效期为 1 年,建议设置 1 年)
- 设置你的个人访问令牌的权限(建议勾选的权限包括
Repo(全部)
,User(全部)
,write:packages
,write:discussion
,admin:repo_hook
) - 以上设置完成后,单击页面下方的【Generate token】生成你的个人访问令牌
- 在创建成功页中,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 导入器开发人员文档。