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

# 在 AWS CodeCommit 存储库中创建或添加文件
<a name="how-to-create-file"></a>

您可以使用 CodeCommit 控制台、AWS CLI 或 Git 客户端将文件添加到存储库。可以从您的本地计算机将文件上传到存储库，或者可以使用控制台中的代码编辑器创建文件。编辑器是一种快速简便的方法，可将单个文件 (例如 readme.md 文件) 添加到存储库中的分支。

![\[在 CodeCommit 控制台中上传文件的视图\]](http://docs.aws.amazon.com/zh_cn/codecommit/latest/userguide/images/codecommit-commit-first-file.png)


**Topics**
+ [创建或上传文件（控制台）](#how-to-create-file-console)
+ [添加文件 (AWS CLI)](#how-to-create-file-cli)
+ [添加文件 (Git)](#how-to-create-file-git)

## 创建或上传文件（控制台）
<a name="how-to-create-file-console"></a>

您可以使用 CodeCommit 控制台创建文件，并将其添加到 CodeCommit 存储库中的分支。在创建文件过程中，可以提供您的用户名和电子邮件地址。您还可以添加提交消息，以便其他用户了解谁添加了文件以及原因。您还可以直接从您的本地计算机将文件上传到存储库中的分支。

**向存储库添加文件**

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

1. 在**存储库**中，选择要将文件添加到其中的存储库。

1. 在**代码**视图中，选择要将文件添加到的分支。默认情况下，在您打开**代码**视图时，将显示默认分支的内容。

   要将视图更改到不同的分支，请选择视图选择器按钮。从下拉列表中选择分支名称，或者在筛选器框中输入分支名称，然后从列表中选择该名称。

1. 选择**添加文件**，然后选择下列选项之一：
   +  要使用代码编辑器创建一个文件的内容并将该文件添加到存储库，请选择**创建文件**。
   + 要将文件从本地计算机上传到存储库，请选择**上传文件**。

1. 向其他用户提供有关谁将此文件添加到存储库以及添加原因的信息。
   + 在**作者姓名**中，输入您的姓名。此姓名同时用作提交信息中的作者姓名和提交者姓名。CodeCommit 默认使用您的 IAM 用户名作为作者姓名，或者从您的控制台登录名派生。
   + 在**电子邮件地址**中，输入一个电子邮件地址，以便其他存储库用户可以就此更改与您联系。
   + 在**提交消息**中，输入简要描述。这是可选的，但强烈建议您这样做。否则，将使用默认的提交消息。

1. 请执行以下操作之一：
   + 如果正在上传文件，请从您的本地计算机选择文件。
   + 如果正在创建文件，请输入您要在代码编辑器中添加的内容，并提供文件的名称。

1. 选择**提交更改**。

## 添加文件 (AWS CLI)
<a name="how-to-create-file-cli"></a>

您可以使用 AWS CLI 和 **put-file** 命令在 CodeCommit 存储库中添加文件。您还可以使用 **put-file** 命令为该文件添加目录或路径结构。

**注意**  
要使用 AWS CLI 命令操作 CodeCommit，请安装 AWS CLI。有关更多信息，请参阅 [命令行参考](cmd-ref.md)。

**向存储库添加文件**

1. 在本地计算机上，创建要添加到 CodeCommit 存储库中的文件。

1. 在终端或命令行中，运行 **put-file** 命令，并指定：
   + 您要将文件添加到的存储库。
   + 您要将文件添加到的分支。
   + 该分支的最近提交的完整提交 ID，也称为最前端提交或 HEAD 提交。
   + 文件的本地位置。用于此位置的语法取决于您的本地操作系统。
   + 您要添加的文件的名称，包括更新的文件在存储库中的存储路径 (如果有)。
   + 您希望与此文件关联的用户名和电子邮件。
   + 一条提交消息，说明您为什么添加此文件。

   用户名、电子邮件地址和提交消息是可选的，但可帮助其他用户知道谁执行的更改以及原因。如果您没有提供用户名，CodeCommit 默认使用您的 IAM 用户名或控制台登录名的派生名称作为作者名。

   例如，要将 *ExampleSolution.py* 文件添加到 *MyDemoRepo* 存储库中的 *feature-randomizationfeature* 分支，并且其最新提交的 ID 为 *4c925148EXAMPLE*，请执行以下操作：

   ```
   aws codecommit put-file --repository-name MyDemoRepo --branch-name feature-randomizationfeature --file-content file://MyDirectory/ExampleSolution.py --file-path /solutions/ExampleSolution.py --parent-commit-id 4c925148EXAMPLE --name "María García" --email "maría_garcía@example.com" --commit-message "I added a third randomization routine."
   ```
**注意**  
当您添加二进制文件时，请确保使用 `fileb://` 指定文件的本地位置。

   如果成功，该命令返回类似以下内容的输出：

   ```
   {
      "blobId": "2eb4af3bEXAMPLE",
      "commitId": "317f8570EXAMPLE",
      "treeId": "347a3408EXAMPLE"
   }
   ```

## 添加文件 (Git)
<a name="how-to-create-file-git"></a>

您可以在本地存储库中添加文件，并将您的更改推送到 CodeCommit 存储库。有关更多信息，请参阅 [Git 入门和 AWS CodeCommit](getting-started.md)。