本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 建立檔案或將檔案新增至 AWS CodeCommit 儲存庫
<a name="how-to-create-file"></a>

您可以使用 CodeCommit 主控台 AWS CLI或 Git 用戶端，將檔案新增至儲存庫。您可以從您的本機電腦上傳檔案至儲存庫，或者您可以使用主控台中的程式碼編輯器來建立檔案。編輯器是新增簡單檔案 (例如 readme.md 檔案) 至儲存庫中分支的一個快速且簡單的方式。

![\[在 CodeCommit 主控台中上傳檔案的檢視\]](http://docs.aws.amazon.com/zh_tw/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：//[https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home)。

1. 在 **Repositories (儲存庫)** 中，選擇您要新增檔案所在的儲存庫。

1. 在 **Code (程式碼)** 檢視中，選擇您要新增檔案所在的分支。依預設，當您開啟 **Code (程式碼)** 檢視時，會顯示預設分支的內容。

   若要將檢視變更至不同的分支，請選擇檢視選取器按鈕。從下拉式清單選擇分支名稱，或是在篩選方塊中輸入分支的名稱，然後從清單中選擇它。

1. 選擇 **Add file (新增檔案)**，然後選擇以下其中一個選項：
   +  若要使用程式碼編輯器來建立檔案的內容，並將它新增至儲存庫，請選擇 **Create file (建立檔案)**。
   + 若要從您的本機電腦將檔案上傳至儲存庫，請選擇 **Upload file (上傳檔案)**。

1. 把將此檔案新增至儲存庫的人員和原因等相關資訊提供給其他使用者。
   + 在 **Author Name (作者名稱)** 中，輸入名稱。此名稱會同時做為遞交資訊中的作者名稱和遞交者名稱。CodeCommit 預設為使用您的 IAM 使用者名稱或主控台登入衍生做為作者名稱。
   + 在**電子郵件地址**中，輸入電子郵件地址，以便其他儲存庫使用者可以就此變更與您聯絡。
   + 在 **Commit message (遞交訊息)** 中，輸入簡短描述。此為選用步驟，但非常建議您加以執行。否則，會使用預設的遞交訊息。

1. 執行以下任意一項：
   + 如果您要上傳檔案，請從您的本機電腦選擇檔案。
   + 如果要建立檔案，請在程式碼編輯器中輸入您要新增的內容，並為檔案提供名稱。

1. 選擇 **Commit changes (遞交變更)**。

## 新增檔案 (AWS CLI)
<a name="how-to-create-file-cli"></a>

您可以使用 AWS CLI 和 **put-file**命令在 CodeCommit 儲存庫中新增檔案。您也可以使用 **put-file** 命令來為檔案新增目錄或路徑結構。

**注意**  
若要搭配 CodeCommit 使用 AWS CLI 命令，請安裝 AWS CLI。如需詳細資訊，請參閱[命令列參考](cmd-ref.md)。

**將檔案新增到儲存庫**

1. 在本機電腦上，建立您要新增至 CodeCommit 儲存庫的檔案。

1. 在終端機或命令列，執行 **put-file** 命令，並指定：
   + 您要新增檔案所在的儲存庫。
   + 您要新增檔案所在的分支。
   + 對該分支所進行最新遞交的完整遞交 ID，也稱為頂端或標頭遞交。
   + 檔案的本機位置。用於此位置的語法因您的本機作業系統而有所不同。
   + 您要新增的檔案名稱，包括已更新檔案在儲存庫中的存放路徑 (如果有)。
   + 要與此檔案建立關聯的使用者名稱和電子郵件。
   + 說明為何新增此檔案的遞交訊息。

   使用者名稱、電子郵件地址和遞交訊息是選用的，但可協助其他使用者知道誰進行了變更以及原因。如果您未提供使用者名稱，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)。