项目创建、导入与迁移
在GitCode平台创建、导入或迁移项目时,请注意以下事项,以确保流程顺利进行。
提示
- 每个项目的路径(包括组织名和项目名)在平台内必须是 唯一 的,请在创建项目时检查路径是否已被占用。
- 如果将项目设置为公开,则所有用户均可访问项目内容,包括代码、Issue、Wiki 等,请确保内容适合公开共享。
操作入口
在任意页面的顶部点击「+ 新建」即可看到「新建项目」、「导入项目」选项。
创建项目
GitCode允许用户创建空白仓库或从现有项目中导入仓库,以便更好地存储、跟踪和协作开发代码。
创建过程中,您可以:
- 将项目创建到 GitCode 帐户/组织
- 根据需求选择创建代码仓、模型仓或数据集仓
- 创建公开项目和私密项目
- 通过选择 README.md、.gitignore、LICENSE 文件来进行项目初始化
导入、迁移项目
导入项目
GitCode 提供了通过 URL 导入项目的功能,使你能够轻松将外部存储库导入到 GitCode 中并进行进一步的管理、协作和版本控制。
URL 导入项目功能可以帮助你:
- 迁移项目:将外部或现有项目无缝迁移到 GitCode 上,以便更好地管理和协作
- 利用 GitCode 功能:利用 GitCode 的版本控制、问题跟踪、Pull Requests 等功能来增强项目管理
- 跨平台合作:允许不同平台上的开发者协作,使项目更具灵活性和可扩展性
如果导入的项目是一个私有项目,则需要提供该项目在源托管平台的凭证,支持个人访问令牌(Token)或“用户名+密码”两种方式。
导入步骤如下:
- 根据需求选择项目类型:代码仓、模型仓或数据集仓
- 输入 Git 项目 URL,URL 必须可用且以
.git
结尾 - 私有项目设置(可选),如果导入的项目是一个私有项目,则还需要提供该项目在源托管平台的凭证,支持个人访问令牌(Token)或 用户名+密码 两种方式
- 选择项目所属帐户:选择要将存储库导入到的 GitCode 帐户/组织
- 配置导入选项:根据你的需求配置导入选项,例如项目名称、路径描述、是否公开等
- 等待导入完成:GitCode 将开始导入项目,你可以在导入进度页面上查看导入进度
以下是使用通过 URL 导入项目功能的最佳实践:
- 在导入项目前,确保外部存储库的 URL 是公开可访问的(私有项目则需要提前准备对应的凭证)
- 仔细配置导入选项,以确保导入过程符合你的项目需求
- 在导入后,定期同步和更新导入的存储库,以确保与外部项目保持同步
迁移项目
GitCode 迁移项目允许你直接从 GitHub、Gitee、GitLab 导入项目,无需手动克隆和推送项目,只需提供你的 GitHub、Gitee、GitLab 个人访问令牌(Personal Access Token,即 PAT),并选择要导入的项目,GitCode 将自动处理剩下的步骤。
提示
目前仅支持项目 git 仓库的迁移,项目 Wiki、Issue、PR 及 Release 暂不支持迁移和导入。
获取访问令牌
要使用 GitCode 迁移项目,你需要先准备 GitHub、Gitee 的个人访问令牌,以便 GitCode 可以访问你的项目仓库。详细的个人访问令牌生成步骤,你可以参考 GitHub、Gitee 的官方网站:
接下来,你可以在 GitCode 的界面上使用简单的步骤完成项目的迁移和导入。
迁移项目的步骤
- 选择迁移平台:选择你要迁移的平台,GitCode 目前支持 Github、Gitee、 GitLab的迁移
- 选择项目所属帐户:选择要将存储库导入到的 GitCode 帐户/组织
- 输入个人访问令牌:在页面的对话框中,输入对应平台的个人访问令牌。确保你的令牌具有适当的权限以访问你要导入的项目,系统会自动记住上一次有效的个人访问令牌,你也可以选择更换新的令牌
- 点击「迁移项目」按钮:点击页面的「迁移项目」按钮
- 选择要导入的项目:在页面上搜索并选择要导入的项目,建议通过 namespace 快速筛选过滤你要导入的项目,你也可以选择批量导入多个项目
- 配置导入选项:根据你的需求配置导入选项,例如项目归属、项目路径等
- 点击「导入项目」:点击「导入」按钮或「批量导入」开始导入项目,系统将自动开始克隆和推送项目仓库到 GitCode
- 等待导入完成:导入过程可能需要一些时间,具体取决于项目仓库的大小和网络速度。请耐心等待,直到导入完成