创建普通仓库

适用于本地有仓库，需要将本地仓库同步到代码托管仓库的场景。在代码托管服务控制台创建空仓库的步骤如下：

1. 进入代码托管服务仓库列表页。
2. 单击“新建仓库”按钮，跳转到“归属项目和仓库类型”页面。
3. 选择“归属项目”。
   

   • 代码仓库必须挂到项目下，通过项目维度查看仓库看板。
   • 如果账号下没有项目请在项目选择框中选择“新建项目”会先弹出“新建项目”页面，这时建立的项目是Scrum或IPD-自运营软件/云服务类。
   • 如果在项目内新建仓库则默认选择该项目。

4. 仓库类型默认选择“普通仓库”。
5. 单击“下一步”按钮，跳转到“基本信息”页面，填写仓库基本信息。

   表1 新建普通仓库参数说明

   字段名称	是否必填	备注说明
   代码仓库名称	是	请以字母、数字、下划线开头，名称还可包含点和连字符，但不能以.git、.atom或.结尾，限制200个字符。
   描述	否	为您的仓库填写描述，限制2000个字符。
   选择gitignore	否	会根据您的选择生成.gitignore文件。（什么是gitignore？）
   权限设置	否	可选择： 允许生成README文件。 您可以通过编辑README文件，记录项目的架构、编写目的等信息，相当于对整个仓库的一种注释。 自动创建代码检查任务（免费）。 仓库创建完成后在代码检查任务列表中，可看到对应仓库的检查任务。 说明： "将项目开发人员自动添加为该仓库成员" 功能下线，不再自动将项目经理和开发人员添加为仓库成员。仅默认将项目创建者、项目管理员加入仓库。 项目成员自动添加到仓库的功能，可基于成员组的成员动态同步能力实现。
   是否公开	是	可选择： 私有。 仓库仅对仓库成员可见，仓库成员可访问仓库或者提交代码。 公开只读。 仓库对所有访客公开只读，但不出现在访客的仓库列表及搜索中。

6. 单击“确定”按钮，完成仓库新建，跳转到仓库列表。

如何关联已有目录或仓库

若在新建普通仓库时，没有勾选“允许生成README文件”，您可以单击仓库“代码”页签中的“生成README文件”，生成一个新的README文件，或者关联已有目录或仓库，具体操作如下。

前提条件

• 以下命令行操作需要您在Git客户端执行，安装Git客户端并配置Git全局用户名和用户邮箱，详情请参考Git客户端安装配置。
• 设置SSH密钥，详情请参考SSH密钥。

操作步骤

以下命令已在您新建仓库中自动生成，您可以在仓库“代码”页签界面中复制获取。

1. 在本地克隆仓库并推送新建的README文件。

   git clone  您的HTTPS下载链接
   cd taskecho "# 仓库名" > README.md
   git add README.md
   git commit -m "add README"
   git push -u origin master

2. 关联已有代码目录到仓库。

   cd <Your directory path>
   mv README.md README-backup.md
   git init
   git remote add origin  您的HTTPS下载链接
   git pull origin master
   git add --all
   git commit -m "Initial commit"
   git push -u origin master

3. 关联已有的Git仓库。

   cd <Your Git repository path>
   git remote remove origin > /dev/null 2>&1
   git remote add origin  您的HTTPS下载链接
   git push -u origin --all -f
   git push -u origin --tags -f