创建普通仓库

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

1. 登录控制台，单击页面左上角，搜索“代码托管”，单击，进入代码托管服务仓库列表页。
2. 单击“新建仓库”按钮，跳转到“归属项目和仓库类型”页面，在“归属项目”下拉框中选择已有的项目或者“新建项目”。
   

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

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

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

   字段名称	是否必填	备注说明
   代码仓库名称	是	请以大小写字母、数字、下划线开头，可包含大小写字母、数字、中划线、下划线、英文句点，但不能以.git、.atom或.结尾，仓库名称至少2个字符，总长度不超过255个字符。
   描述	否	为您的仓库填写描述，限制2000个字符。
   选择gitignore	否	会根据您的选择生成.gitignore文件。（什么是gitignore？）
   初始化设置	否	可选择： 允许生成README文件。 您可以通过编辑README文件，记录项目的架构、编写目的等信息，相当于对整个仓库的一种注释。 说明： "将项目开发人员自动添加为该仓库成员" 功能下线，不再自动将项目经理和开发人员添加为仓库成员。仅默认将项目创建者、项目管理员加入仓库。
   是否公开	是	可选择： 私有(仓库仅对仓库成员可见，仓库成员可访问仓库或者提交代码)。 公开只读(仓库对所有访客公开只读，但不出现在访客的仓库列表及搜索中 )
   添加开源许可证	否	如果仓库设置为公开，可下拉选择已有的许可证。

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

如何关联已有目录或仓库

如果在新建普通仓库时，没有勾选“允许生成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