
# 新建自定义代码仓库
#### 场景概述
为帮助您规范、顺利完成自定义代码仓库的创建，本章节将详细介绍CodeArts Repo中新建自定义代码仓库的具体操作步骤、各配置参数的填写规范与要求。
#### 约束与限制
用户在新建自定义仓库前，请先查看[前提条件](https://support.huaweicloud.com/usermanual-codeartsrepo/codeartsrepo_03_0103.html)。
1. 如下图所示，进入CodeArts Repo首页。单击"新建仓库"，在"归属项目"下拉框中选择已有的项目或者"新建项目"。 
   ![](https://support.huaweicloud.com/usermanual-codeartsrepo/zh-cn_image_0000002393748920.png "点击放大")
   
   
   
   
2. 仓库类型选择"普通新建"，单击"下一步"，根据[表格]填写参数。
   
    表1新建仓库的参数说明 
   | 字段名称        | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   |:---|:---|
   | 代码组路径       | 非必填。该参数表示新仓库的目标代码组路径，用户可以下拉框选择代码组路径。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   | 代码仓库名称      | 填写该参数时，需要以大小写字母、数字、下划线开头，可包含大小写字母、数字、中划线、下划线、英文句点，但不能以.git、.atom或.结尾。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
   | 描述          | 该参数为非必填。该参数限制2000个字符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
   | 选择gitignore | 该参数为非必填。推荐用户填写该参数，下拉框选择代码仓库要开发的编程语言，可以避免后续不必要的文件被跟踪，以此保持代码库的整洁和可维护性。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   | 初始化设置       | 该参数为非必填。包括两个选项： - 允许生成README文件。推荐用户勾选该选项，生成该文件后，用户可以通过编辑README文件，记录项目的架构、编写目的等信息，帮助其他人更快了解该代码仓。  - 自动创建代码检查任务（免费）。**用户需要确保已经具有代码检查权限，否则配置无法生效** 。 推荐用户勾选该选项，代码仓库创建完成后，在代码检查(CodeArts Check)任务列表中，可看到对应仓库的检查任务。                                                                                                                                                                                                                                                               |
   | 可见范围        | 该参数为非必填。用户可根据自己的需求进行选择，包括两个选项： - 私有(仓库仅对仓库成员可见，仓库成员可访问仓库或者提交代码)。  - 公开。包含三个选项："项目内成员只读"、"租户内成员只读"和"所有访客只读"。 代码仓库可以相互转换"私有"或者"公开"，进入要设置的代码仓库详情页面，选择"设置 \> 基本设置 \> 仓库信息"，修改代码仓库的可见范围。 **项目内成员只读：**仓库对项目内成员公开只读，并且项目内成员可在项目下和代码组下的仓库列表中查看和搜索。 **租户内成员只读：**仓库对租户内成员公开只读，并且租户内成员可在项目下和代码组下的仓库列表中查看和搜索。 **所有访客只读：**仓库对所有访客公开只读，并且所有访客可在项目下和代码组下的仓库列表中查看和搜索。    |
   | 添加开源许可证     | 该参数在"可见范围"选择为"公开只读"时必填。下拉框选择已有的许可证。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
      
   
   
3. 单击"确定"后，自动跳转到新建仓库的"代码"页面。如下图所示，成功新建仓库"Test_Repo"。 
   图1成功新建仓库"Test_Repo"
   ![](https://support.huaweicloud.com/usermanual-codeartsrepo/zh-cn_image_0000002513458069.png "点击放大")
   
   
![](https://support.huaweicloud.com/usermanual-codeartsrepo/public_sys-resources/caution_3.0-zh-cn.png)
- 当用户在创建一个"所有访客只读"的公开仓时，如果用户的"代码仓库名称"或者"描述"包含敏感词汇，包括中文和英文语法，将会新建仓库失败，并且在"新建仓库"页面的右上角提示"用户所提交的内容可能存在违反法律法规的内容，请修改后重新提交。"
- 如果用户在尝试修改设置为'所有访客只读'的公开"仓库描述"或者"分享标题"时使用了敏感词汇，那么修改操作将会失败。
- 如果用户在"README.md"文件输入敏感词汇和图片，进入此代码仓的"仓库首页"，右上角会显示"审核状态：不通过"，即当前仓库仅项目内成员可见，需要修改"README.md"文件内容。
- 在新建代码仓库后，仅有创建者能够访问该仓库。其他项目成员需要手动添加到仓库中，并分配相应的权限。因此，用户需要根据需求，手动为代码仓库添加成员并为新增成员配置访问权限。
 
