本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 创建 Amazon CodeCommit 存储库
<a name="how-to-create-repository"></a>

使用 Amazon CodeCommit 控制台或 Amazon Command Line Interface (Amazon CLI) 创建空 CodeCommit 存储库。要在创建存储库后为其添加标签，请参阅[为存储库添加标签](how-to-tag-repository-add.md)。

以下说明假定您已完成[设置 ](setting-up.md) 中的步骤。

**注意**  
根据您的使用情况，您可能需要为创建或访问存储库付费。有关更多信息，请参阅 CodeCommit 产品信息页面上的[定价](https://www.amazonaws.cn/codecommit/pricing)。

**Topics**
+ [创建存储库（控制台）](#how-to-create-repository-console)
+ [创建存储库 (Amazon CLI)](#how-to-create-repository-cli)

## 创建存储库（控制台）
<a name="how-to-create-repository-console"></a>

**创建存储 CodeCommit 库**

1. 在 [https://console.aws.amazon.com/codesuite/codemmit](https://console.amazonaws.cn/codesuite/codecommit/home) /home 打开 CodeCommit 控制台。

1. 在区域选择器中，选择要创建存储库 Amazon Web Services 区域 的位置。有关更多信息，请参阅 [区域和 Git 连接端点](regions.md)。

1. 在**存储库**页面上，选择**创建存储库**。

1. 在**创建存储库**页面上的**存储库名称**中，为存储库输入名称。
**注意**  
存储库名称区分大小写。名称在 Amazon Web Services 区域 中对于 Amazon Web Services 账户必须唯一。

1. （可选）在**描述**中，输入存储库的描述。这可以帮助您及其他用户了解存储库的用途。
**注意**  
“描述”字段在控制台中显示“Markdown”，并接受所有 HTML 字符和有效的 Unicode 字符。如果您是使用`GetRepository`或的应用程序开发人员，`BatchGetRepositories` APIs 并且计划在 Web 浏览器中显示存储库描述字段，请参阅 [CodeCommit API 参考](https://docs.amazonaws.cn/codecommit/latest/APIReference/)。

1. （可选）选择 **Add t** ag，向存储库添加一个或多个存储库标签（可帮助您组织和管理 Amazon 资源的自定义属性标签）。有关更多信息，请参阅 [在中标记存储库 Amazon CodeCommit](how-to-tag-repository.md)。

1. （可选）展开**其他配置**以指定是使用默认密钥 Amazon 托管式密钥 还是您自己的客户托管密钥来加密和解密此存储库中的数据。如果您选择使用自己的客户托管密钥，则必须确保该密钥在您创建存储库 Amazon Web Services 区域 的地方可用，并且该密钥处于活动状态。有关更多信息，请参阅 [Amazon Key Management Service 以及 Amazon CodeCommit 存储库的加密](encryption.md)。

1. （可选）如果此存储库包含 **Java 或 Python 代码，并且您想让 CodeGuru Reviewer 对其进行分析，请选择 “启用 Java 和 Python 版 Ama** zon CodeGuru Reviewer”。 CodeGuru Reviewer 使用多个机器学习模型来查找代码缺陷，并对拉取请求提出改进和修复建议。有关更多信息，请参阅 [https://docs.amazonaws.cn/codeguru/latest/reviewer-ug/Welcome.html](https://docs.amazonaws.cn/codeguru/latest/reviewer-ug/Welcome.html)。

1. 选择**创建**。

创建存储库后，您可以通过 CodeCommit 控制台或本地 Git 客户端，或者通过将 CodeCommit 仓库与您最喜欢的 IDE 集成来连接到该仓库并开始添加代码。有关更多信息，请参阅 [Setting up for Amazon CodeCommit](setting-up.md)。您也可以将存储库添加到持续交付管道中。有关更多信息，请参阅[简单管道演练](https://docs.amazonaws.cn/codepipeline/latest/userguide/getting-started-cc.html)。

要获取有关新 CodeCommit 存储库的信息，例如克隆存储库时 URLs 要使用的，请从列表中选择存储库的名称，或者直接在存储库名称旁边选择要使用的连接协议。

要与其他用户共享该存储库，您必须向其发送用于克隆该存储库的 HTTPS 或 SSH 链接。确保他们具备访问该存储库所需的权限。有关更多信息，请参阅[共享存储库](how-to-share-repository.md)和[的身份验证和访问控制 Amazon CodeCommit](auth-and-access-control.md)。

## 创建存储库 (Amazon CLI)
<a name="how-to-create-repository-cli"></a>

您可以使用 Amazon CLI 来创建 CodeCommit 存储库。与控制台不同，如果使用 Amazon CLI创建存储库，您可以为其添加标签。

1. 确保您已使用存储库 Amazon CLI 的存在 Amazon Web Services 区域 位置进行配置。要验证区域，请在命令行或终端中运行以下命令，并查看默认区域名称的信息。

   ```
   aws configure
   ```

   中存储库的默认区域名称必须与中存储库 Amazon Web Services 区域 的名称相匹配 CodeCommit。有关更多信息，请参阅 [区域和 Git 连接端点](regions.md)。

1. 运行 **create-repository** 命令，并指定：
   + 唯一标识 CodeCommit 存储库的名称（带`--repository-name`选项）。
**注意**  
该名称必须在 Amazon Web Services 账户间保持唯一。
   + 关于 CodeCommit 存储库的可选评论（带`--repository-description`选项）。
   + 一个或多个可选的键值对，用作 CodeCommit 存储库的标签（带`--tags`选项）。
   + 加密和解密此存储库时使用的可选客户托管密钥。所有存储库都使用 Amazon KMS中的密钥进行传输中和静态加密。如果未指定密钥，`aws/codecommit`则使用默认的 Amazon 托管密钥。

   例如，要创建一个名为的 CodeCommit 存储库`MyDemoRepo`，其描述`"My demonstration repository"`和标签的密钥名为*Team*的值为的标签*Saanvi*，请使用此命令。

   ```
   aws codecommit create-repository --repository-name MyDemoRepo --repository-description "My demonstration repository" --tags Team=Saanvi
   ```
**注意**  
“描述”字段在控制台中显示“Markdown”，并接受所有 HTML 字符和有效的 Unicode 字符。如果您是使用`GetRepository`或的应用程序开发人员，`BatchGetRepositories` APIs 并且计划在 Web 浏览器中显示存储库描述字段，请参阅 [CodeCommit API 参考](https://docs.amazonaws.cn/codecommit/latest/APIReference/)。

1. 如果成功，此命令会输出一个包含以下信息的 `repositoryMetadata` 对象：
   + 说明 (`repositoryDescription`)。
   + 系统生成的唯一 ID (`repositoryId`)。
   + 名称 (`repositoryName`)。
   + 与 CodeCommit 存储库关联的 Amazon Web Services 账户的 ID (`accountId`)。

   以下是基于上述示例命令的示例输出。

   ```
   {
       "repositoryMetadata": {
           "repositoryName": "MyDemoRepo",
           "cloneUrlSsh": "ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo",
           "lastModifiedDate": 1446071622.494,
           "repositoryDescription": "My demonstration repository",
           "cloneUrlHttp": "https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo",
           "defaultBranch": main,
           "kmsKeyId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
           "creationDate": 1446071622.494,
           "repositoryId": "f7579e13-b83e-4027-aaef-650c0EXAMPLE",
           "Arn": "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo",
           "accountId": "111111111111"
       }
   }
   ```
**注意**  
不会在输出中返回创建存储库时添加的标签。要查看与存储库关联的标签列表，请运行 **[list-tags-for-resource](how-to-tag-repository-list.md)** 命令。

1. 记下 CodeCommit 存储库的名称和 ID。您需要它们来监视和更改有关 CodeCommit 存储库的信息，尤其是在您使用时 Amazon CLI。

   如果您忘记了名称或 ID，请按照[查看 CodeCommit 存储库详细信息 (Amazon CLI)](how-to-view-repository-details.md#how-to-view-repository-details-cli)中的说明操作。

创建存储库后，您可以连接到该存储库并开始添加代码。有关更多信息，请参阅 [连接存储库](how-to-connect.md)。您也可以将存储库添加到持续交付管道中。有关更多信息，请参阅[简单管道演练](https://docs.amazonaws.cn/codepipeline/latest/userguide/getting-started-cc.html)。