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

# 建立 AWS CodeCommit 儲存庫
<a name="how-to-create-repository"></a>

使用 AWS CodeCommit 主控台或 AWS Command Line Interface (AWS CLI) 來建立空的 CodeCommit 儲存庫。若要在建立之後將標籤新增到存放庫，請參閱[新增標籤至儲存庫](how-to-tag-repository-add.md)。

這些說明假設您已完成[設定 ](setting-up.md)中的步驟。

**注意**  
根據您的用量，您可能需要支付建立或存取儲存庫的費用。如需詳細資訊，請參閱 CodeCommit 產品資訊頁面上的[定價](https://aws.amazon.com/codecommit/pricing)。

**Topics**
+ [建立儲存庫 （主控台）](#how-to-create-repository-console)
+ [建立儲存庫 (AWS CLI)](#how-to-create-repository-cli)

## 建立儲存庫 （主控台）
<a name="how-to-create-repository-console"></a>

**建立 CodeCommit 儲存庫**

1. 在 https：//[https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home) 開啟 CodeCommit 主控台。

1. 在區域選擇器中，選擇您要建立儲存庫的 AWS 區域 。如需詳細資訊，請參閱[區域和 Git 連線端點](regions.md)。

1. 請在 **Repositories** (儲存庫) 頁面上，選擇 **Create repository** (建立儲存庫)。

1. 在 **Create repository (建立儲存庫)** 頁面的 **Repository name (儲存庫名稱)** 中，輸入儲存庫的名稱。
**注意**  
儲存庫名稱區分大小寫。名稱在您的 Amazon Web Services 帳戶的 AWS 區域 中必須是唯一的。

1. (選用) 在 **Description (描述)** 中，輸入儲存庫的描述。這可協助您和其他使用者識別儲存庫的用途。
**注意**  
描述欄位會在主控台中顯示 Markdown，並接受所有 HTML 字元和有效的 Unicode 字元。如果您是使用 `GetRepository`或 `BatchGetRepositories` APIs 的應用程式開發人員，並且打算在 Web 瀏覽器中顯示儲存庫描述欄位，請參閱 [CodeCommit API 參考](https://docs.aws.amazon.com/codecommit/latest/APIReference/)。

1. （選用） 選擇**新增標籤**，將一或多個儲存庫標籤 （可協助您組織和管理 AWS 資源的自訂屬性標籤） 新增至儲存庫。如需詳細資訊，請參閱[在 中標記儲存庫 AWS CodeCommit](how-to-tag-repository.md)。

1. （選用） 展開**其他組態**，以指定是否使用預設值 AWS 受管金鑰 或您自己的客戶受管金鑰來加密和解密此儲存庫中的資料。如果您選擇使用自己的客戶受管金鑰，則必須確保它在您建立儲存庫 AWS 區域 的 中可用，且金鑰處於作用中狀態。如需詳細資訊，請參閱[AWS Key Management Service 和 AWS CodeCommit 儲存庫的加密](encryption.md)。

1. （選用） 如果此儲存庫包含 **Java 或 Python 程式碼，且您希望 CodeGuru Reviewer 對其進行分析，請選取啟用適用於 Java 和 Python 的 Amazon** CodeGuru Reviewer。 CodeGuru CodeGuru Reviewer 使用多個機器學習模型來尋找程式碼瑕疵，並在提取請求中建議改進和修正。如需詳細資訊，請參閱 [https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/Welcome.html](https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/Welcome.html)。

1. 選擇**建立**。

建立儲存庫之後，您可以透過 CodeCommit 主控台或本機 Git 用戶端，或將 CodeCommit 儲存庫與您偏好的 IDE 整合，來連線到該儲存庫並開始新增程式碼。如需詳細資訊，請參閱[設定 AWS CodeCommit](setting-up.md)。您也可以將您的儲存庫新增到持續交付管道。如需詳細資訊，請參閱[簡易管道演練](https://docs.aws.amazon.com/codepipeline/latest/userguide/getting-started-cc.html)。

若要取得新 CodeCommit 儲存庫的相關資訊，例如複製儲存庫時要使用URLs，請從清單中選擇儲存庫的名稱，或只選擇您要在儲存庫名稱旁使用的連線通訊協定。

若要與他人共用這個儲存庫，您必須將 HTTPS 或 SSH 連結傳送給他們，以用來複製儲存庫。確定他們擁有存取儲存庫所需的許可。如需詳細資訊，請參閱[共用儲存庫](how-to-share-repository.md)及[的身分驗證和存取控制 AWS CodeCommit](auth-and-access-control.md)。

## 建立儲存庫 (AWS CLI)
<a name="how-to-create-repository-cli"></a>

您可以使用 AWS CLI 來建立 CodeCommit 儲存庫。與主控台不同的是，如果您使用 AWS CLI來建立，您可以將標籤新增到儲存庫。

1. 請確定您已 AWS CLI 使用儲存庫所在的 設定 AWS 區域 。若要驗證區域，請在命令列或終端機執行下列命令，並檢閱預設區域名稱的資訊：

   ```
   aws configure
   ```

   預設區域名稱必須符合 CodeCommit 中儲存庫 AWS 區域 的 。如需詳細資訊，請參閱[區域和 Git 連線端點](regions.md)。

1. 執行 **create-repository** 命令，並指定：
   + 唯一識別 CodeCommit 儲存庫的名稱 （使用 `--repository-name`選項）。
**注意**  
此名稱在 Amazon Web Services 帳戶中必須是唯一的。
   + CodeCommit 儲存庫的選用註解 （使用 `--repository-description`選項）。
   + 選用的鍵/值對或對，用作 CodeCommit 儲存庫的標籤 （使用 `--tags`選項）。
   + 加密和解密此儲存庫時要使用的選用客戶受管金鑰。所有儲存庫都會使用 中的金鑰在傳輸中和靜態時加密 AWS KMS。如果未指定金鑰，`aws/codecommit`則會使用預設的 AWS 受管金鑰。

   例如，若要建立名為 `MyDemoRepo`且描述為 的 CodeCommit 儲存庫，`"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.aws.amazon.com/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 儲存庫的相關資訊，尤其是在使用 時 AWS CLI。

   如果您忘記名稱或 ID，請遵循[檢視 CodeCommit 儲存庫詳細資訊 (AWS CLI)](how-to-view-repository-details.md#how-to-view-repository-details-cli)中的指示。

建立儲存庫之後，您可以連接到該儲存庫，並開始新增程式碼。如需詳細資訊，請參閱[連接到儲存庫](how-to-connect.md)。您也可以將您的儲存庫新增到持續交付管道。如需詳細資訊，請參閱[簡易管道演練](https://docs.aws.amazon.com/codepipeline/latest/userguide/getting-started-cc.html)。