

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

# 開始使用
<a name="getting-started-topnode"></a>

開始使用 CodeCommit 的最簡單方法是遵循 中的步驟[開始使用 CodeCommit ](getting-started-cc.md)。如果您是初次使用 Git 和 CodeCommit，也應考慮遵循中的步驟[Git 和 CodeCommit 入門](getting-started.md)。這可協助您熟悉 CodeCommit，以及在與 CodeCommit 儲存庫互動時使用 Git 的基本概念。

您也可以遵循使用 [ CodePipeline 和 CodeCommit 進行簡易管道演練](https://docs.aws.amazon.com/codepipeline/latest/userguide/getting-started-cc.html)中的教學課程，了解如何使用 CodeCommit 儲存庫作為持續交付管道的一部分。

本節中的教學課程假設您已完成[先決條件和設定](setting-up.md)，包括：
+ 將許可指派給 IAM 使用者。
+ 在您用於本教學課程的本機機器上，設定 HTTPS 或 SSH 連線的登入資料管理。
+  AWS CLI 如果您想要對所有操作使用命令列或終端機，包括建立儲存庫，請設定 。

**Topics**
+ [入門 AWS CodeCommit](getting-started-cc.md)
+ [Git 和 入門 AWS CodeCommit](getting-started.md)

# 入門 AWS CodeCommit
<a name="getting-started-cc"></a>

本教學課程說明如何使用一些 CodeCommit 主要功能。首先，您建立儲存庫並遞交一些變改給它。然後，您瀏覽檔案，並檢視變更。您也可以建立提取請求，讓其他使用者可以檢閱程式碼的變更並作評論。

如果您想要將現有程式碼遷移至 CodeCommit，請參閱 [遷移至 AWS CodeCommit](how-to-migrate-repository.md)。

如果你不熟悉 Git，也可以考慮完成[Git 和 CodeCommit 入門](getting-started.md)。完成這些教學課程後，您應該有足夠的實務來開始將 CodeCommit 用於您自己的專案和團隊環境中。

CodeCommit 主控台在可摺疊面板中包含實用資訊，您可以從頁面上的資訊圖示 (![\[The information icon that opens and closes the help panel on a page.\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-info-icon.png)) 或任何**資訊**連結開啟。您隨時皆可關閉此面板。

![\[在主控台檢視其他指導\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-guidance-open.png)


CodeCommit 主控台也提供快速搜尋資源的方法，例如儲存庫、建置專案、部署應用程式和管道。選擇 **Go to resource (移至資源)**，或按 `/` 鍵，然後輸入資源名稱。任何相符項目都會出現在清單中。搜尋不區分大小寫。您只會看到您有權檢視的資源。如需詳細資訊，請參閱[在主控台檢視資源](auth-and-access-control-iam-identity-based-access-control.md#console-resources)。

## 先決條件
<a name="getting-started-cc-prereqs"></a>

開始之前，您必須完成[先決條件和設定](setting-up.md)程序，包括：
+ 將許可指派給 IAM 使用者。
+ 在本教學課程所使用的本機電腦上，設定 HTTPS 或 SSH 連線的登入資料管理。
+  AWS CLI 如果您想要對所有操作使用命令列或終端機，包括建立儲存庫，請設定 。

**Topics**
+ [先決條件](#getting-started-cc-prereqs)
+ [步驟 1：建立 CodeCommit 儲存庫](#getting-started-cc-create-repo)
+ [步驟 2：將檔案新增至您的儲存庫](#getting-started-cc-add)
+ [步驟 3：瀏覽儲存庫的內容](#getting-started-cc-browse)
+ [步驟 4：建立和協作提取請求](#getting-started-cc-pullrequest)
+ [步驟 5：清除](#getting-started-cc-clean-up)
+ [步驟 6：後續步驟](#getting-started-cc-next)

## 步驟 1：建立 CodeCommit 儲存庫
<a name="getting-started-cc-create-repo"></a>

您可以使用 CodeCommit 主控台來建立 CodeCommit 儲存庫。如果您已經有要用於此教學的儲存庫，則可略過此步驟。

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

**建立 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 (儲存庫名稱)** 中，輸入儲存庫的名稱 (例如 **MyDemoRepo**)。
**注意**  
儲存庫名稱需區分大小寫且不能超過 100 個字元。如需詳細資訊，請參閱[限制](limits.md#limits-repository-names)。

1. (選用) 在 **Description (描述)** 中，輸入描述 (例如，**My demonstration repository**)。這可協助您和其他使用者識別儲存庫的用途。

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 Reviewer 使用多個機器學習模型來尋找程式碼瑕疵，並在提取請求中自動建議改進和修正。如需詳細資訊，請參閱 Amazon CodeGuru Reviewer 使用者指南。

1. 選擇**建立**。

![\[從主控台建立儲存庫\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-create-repository.png)


**注意**  
如果您的儲存庫使用 `MyDemoRepo` 以外的名稱，請務必在剩餘的步驟中使用該名稱。

儲存庫開啟時，您會看到如何直接從 CodeCommit 主控台新增檔案的相關資訊。

## 步驟 2：將檔案新增至您的儲存庫
<a name="getting-started-cc-add"></a>

您可以透過以下方式，將檔案新增至儲存庫：
+ 在 CodeCommit 主控台中建立檔案。如果您在 主控台中為儲存庫建立第一個檔案，則會為您建立名為 *main* 的分支。此分支是您儲存庫的預設分支。
+ 使用 CodeCommit 主控台從本機電腦上傳檔案。如果您從主控台上傳儲存庫的第一個檔案，則會為您建立名為 *main* 的分支。此分支是您儲存庫的預設分支。
+ 使用 Git 用戶端將儲存庫複製到本機電腦，然後將檔案新增、遞交和推送至 CodeCommit 儲存庫。在第一次從 Git 遞交時，會為您建立分支，並設定為儲存庫的預設分支。分支的名稱是 Git 用戶端的預設選擇。考慮將您的 Git 用戶端設定為使用*主要* 做為初始分支的名稱。

**注意**  
您可以隨時建立分支和變更儲存庫的預設分支。如需詳細資訊，請參閱[在 AWS CodeCommit 儲存庫中使用分支](branches.md)。

開始使用的最簡單方法是開啟 CodeCommit 主控台並新增檔案。如此一來，您也可以為名為 *main* 的儲存庫建立預設分支。如需如何使用 新增檔案和建立第一次遞交至儲存庫的指示 AWS CLI，請參閱[使用 為儲存庫建立第一次遞交 AWS CLI](how-to-create-commit.md#create-first-commit)。

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

1. 在儲存庫的導覽列中，選擇 **Code (程式碼)**。

1. 選擇 **Add file (新增檔案)**，然後選擇是否建立檔案或從電腦上傳檔案。本教學課程將告訴您如何執行這兩項操作。

1. 若要新增檔案，請執行下列操作：

   1. 在分支的下拉式清單中，選擇您要新增檔案的分支。系統會自動為您選取預設分支。在此範例中，預設分支名為 *main*。如果要將檔案新增至不同的分支，請選擇不同的分支。

   1.  在 **File name (檔案名稱)** 中，輸入檔案的名稱。在程式碼編輯器中，輸入檔案的程式碼。

   1. 在 **Author name (作者名稱)** 中，輸入您要向其他儲存庫使用者顯示的名稱。

   1. 在 **Email address (電子郵件地址)** 中，輸入電子郵件地址。

   1. (選用) 在 **Commit message (遞交訊息)** 中，輸入簡短訊息。雖然這是選用的，但建議您新增遞交訊息，以幫助團隊成員了解您新增這個檔案的原因。如果未輸入遞交訊息，則會使用預設訊息。

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

   若要上傳檔案，請執行下列操作：
   + 如果是上傳檔案，請選擇您要上傳的檔案。  
![\[在 CodeCommit 主控台中上傳檔案的檢視\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-commit-first-file.png)
   + 在 **Author name (作者名稱)** 中，輸入您要向其他儲存庫使用者顯示的名稱。
   + 在 **Email address (電子郵件地址)** 中，輸入電子郵件地址。
   + (選用) 在 **Commit message (遞交訊息)** 中，輸入簡短訊息。雖然這是選用的，但建議您新增遞交訊息，以幫助團隊成員了解您新增這個檔案的原因。如果未輸入遞交訊息，則會使用預設訊息。
   + 選擇 **Commit changes (遞交變更)**。

如需詳細資訊，請參閱[使用 AWS CodeCommit 儲存庫中的檔案](files.md)。

若要使用 Git 用戶端複製儲存庫，請在本機電腦上安裝 Git，然後複製 CodeCommit 儲存庫。將一些檔案新增至本機儲存庫，並將其推送至 CodeCommit 儲存庫。如需深入介紹，請參閱[Git 和 CodeCommit 入門](getting-started.md)。如果您熟悉 Git，但不確定如何使用 CodeCommit 儲存庫執行此操作，您可以在 [建立遞交](how-to-create-commit.md)、 [步驟 2：建立本機儲存庫](getting-started.md#getting-started-set-up-folders)或 中檢視範例和指示[連接到儲存庫](how-to-connect.md)。

將一些檔案新增至 CodeCommit 儲存庫後，您可以在 主控台中檢視這些檔案。

## 步驟 3：瀏覽儲存庫的內容
<a name="getting-started-cc-browse"></a>

您可以使用 CodeCommit 主控台來檢閱儲存庫中的檔案，或快速讀取檔案的內容。這有助於您決定要檢查的分支，或是否建立儲存庫的本機副本。

**瀏覽儲存庫**

1. 從**儲存庫**中，選擇 MyDemoRepo。

1. 頁面會顯示儲存庫的預設分支中的內容。若要檢視其他分支或檢視特定標籤上的程式碼，請從清單中選擇您要檢視的分支或標籤。在下列螢幕擷取畫面中，檢視會設定為**主**分支。  
![\[瀏覽儲存庫的內容\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-code-browse.png)

1. 若要檢視儲存庫中某個檔案的內容，請從清單中選擇檔案。若要變更顯示的程式碼顏色，請選擇設定圖示。  
![\[檢視檔案的內容\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-code-browse-file.png)

   如需詳細資訊，請參閱[瀏覽儲存庫中的檔案](how-to-browse.md)。

1. 若要瀏覽儲存庫的遞交歷史記錄，請選擇 **Commits (遞交)**。主控台會以相反的時間順序顯示預設分支的遞交歷史記錄。依作者、日期等檢閱遞交詳細資料。  
![\[主控台的遞交歷史記錄檢視\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-code-history.png)

1. 若要依[分支](branches.md)或 [Git 標籤](how-to-view-tag-details.md)檢視遞交歷史記錄，請從清單中選擇您要檢視的分支或標籤。

1. 若要檢視遞交與其父遞交之間的差異，請選擇縮寫的遞交 ID。您可以選擇如何顯示變更，包括顯示或隱藏空格變更，以及是否以內嵌 (**Unified (統一)**檢視) 或並排 (**Split (分割)**檢視) 方式來檢視變更。
**注意**  
用於檢視程式碼的偏好設定及其他主控台設定只要有變動，就會儲存為瀏覽器 Cookie。如需詳細資訊，請參閱[使用使用者偏好設定](user-preferences.md)。  
![\[統一檢視中顯示的變更，並顯示空格變更\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-commit-changes2c.png)

1. 若要檢視遞交的所有註解，請選擇遞交，然後捲動變更以內嵌方式檢視。您也可以新增自己的註解，並回覆其他人所做的註解。

   如需詳細資訊，請參閱[對遞交做註解](how-to-commit-comment.md)。

1. 若要檢視任何兩個遞交指標之間的差異，包括標籤、分支和遞交 ID，請在導覽窗格中選擇 **Commits (遞交)**，然後選擇 **Compare commits (比較遞交)**。  
![\[在分割檢視中比較遞交與分支頂端\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-compare-4.png)

   如需詳細資訊，請參閱[瀏覽儲存庫的遞交歷史記錄](how-to-view-commit-details.md#how-to-view-commit-details-console-history)及[比較遞交](how-to-compare-commits.md)。

1. 在 **Commits (遞交)** 中，選擇 **Commit visualizer (遞交視覺化工具)** 標籤。  
![\[主控台的儲存庫圖表檢視\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-cv-complex1.png)

   隨即顯示遞交圖表，在圖表中，每個遞交會在該點旁邊顯示主旨列。主旨列最多顯示 80 個字元。

1. 若要查看遞交的詳細資訊，請選擇其縮寫遞交 ID。若要呈現從特定遞交開始的圖表，請在圖表中選擇該點。如需詳細資訊，請參閱[檢視儲存庫遞交歷史記錄的圖表](how-to-view-commit-details.md#how-to-view-commit-details-console-visualizer)。

## 步驟 4：建立和協作提取請求
<a name="getting-started-cc-pullrequest"></a>

當您與其他使用者在儲存庫中工作時，你們可以協同處理程式碼並檢閱變更。您可以建立提取請求，讓其他使用者可以檢閱您在分支中的程式碼變更並作評論。您也可以為提取請求建立一或多個核准規則。例如，您可以建立核准規則，要求至少兩位其他使用者核准提取請求後，才能合併提取請求。核准提取請求之後，您可以將這些變更合併到目的地分支中。如果您為儲存庫設定通知，則儲存庫使用者可以收到與儲存庫事件相關的電子郵件 (例如提取請求或當有人對程式碼做註解時)。如需詳細資訊，請參閱[設定 AWS CodeCommit 儲存庫中事件的通知](how-to-repository-email.md)。

**重要**  
您必須建立分支，其中包含您希望檢閱的程式碼變更，才能建立提取請求。如需詳細資訊，請參閱[建立分支](how-to-create-branch.md)。

**建立和協同處理提取請求**

1. 在導覽窗格中，選擇 **Pull requests (提取請求)**。

1. 在 **Pull request (提取請求)** 中，選擇 **Create pull request (建立提取請求)**。
**提示**  
您也可以從 **Branches (分支)** 和 **Code (程式碼)** 建立提取請求。

   在 **Create pull request (建立提取請求)** 的 **Source (來源)** 中，選擇分支，其中包含您希望檢閱的變更。在 **Destination (目的地)** 中，選擇分支，表示您希望提取請求關閉時，將已檢閱的程式碼合併到此分支。選擇 **Compare (比較)**。

1. 檢閱合併詳細資訊和變更，以確認提取請求包含您希望檢閱的變更和遞交。如果沒問題，請在 **Title (標題)** 中輸入此檢閱的標題。這是在儲存庫的提取請求清單中顯示的標題。在 **Description (描述)** 中，輸入有助於了解此檢閱的詳細資訊，以及對檢閱者有用的任何其他資訊。選擇**建立**。  
![\[建立提取請求\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-pull-request-create.png)

1. 您的提取請求會出現在儲存庫的提取請求清單中。您可以篩選檢視，只顯示開啟的請求、關閉的請求、您建立的請求等等。  
![\[檢視儲存庫中的提取請求\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-pull-request-view.png)

1. 您可以將核准規則新增至提取請求，以確保在合併之前符合特定條件。若要將核准規則新增至提取請求，請從清單中選擇提取請求。在 **Approvals (核准)** 索引標籤上，選擇 **Create approval rule (建立核准規則)**。

1. 在 **Rule name (規則名稱)** 中，為規則指定描述性名稱。例如，如果需要兩個人先核准提取請求後，才能合併提取請求，您可以將規則命名為 **Require two approvals before merge**。在 **Number of approvals needed (需要的核准數目)** 中，輸入 **2**，此為您要的數目。預設為 1。選擇**提交**。若要深入了解核准規則和核准集區成員，請參閱[建立提取請求的核准規則](how-to-create-pull-request-approval-rule.md)。  
![\[建立提取請求的核准規則\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-create-approval-rule.png)

1. 如果您為儲存庫設定通知，並選擇將提取請求事件通知使用者，則使用者會收到新提取請求的相關電子郵件。使用者可以檢視特定程式碼行、檔案和提取請求本身的變更並做註解。他們也可以使用文字和表情符號回覆評論。如有需要，您可以將變更推送到提取請求分支，以更新提取請求。  
![\[將表情符號反應新增至提取請求的註解。\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-commenting-commenttab.png)

1. 如果您對請求中所做的變更感到滿意，請選擇 **Approve (核准)**。即使未設定提取請求的核准規則，您也可以選擇核准該提取請求。這會清楚記錄您已檢閱提取請求及核准變更。如果您改變主意，您也可以選擇撤銷核准。  
![\[檢視提取請求的核准\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-pull-request-approvals.png)
**注意**  
您無法核准您自己建立的提取請求。

1. 當您滿意所有程式碼變更都經過檢閱並獲得同意時，請從提取請求執行下列其中一項動作：
   + 如果您想關閉提取請求但不合併分支，請選擇 **Close pull request (關閉提取請求)**。
   + 如果您要合併分支並關閉提取請求，請選擇 **Merge (合併)**。您可以在適用於您程式碼的合併策略之間選擇 (這取決於來源和目的地分支之間的差異)，以及是否在完成合併之後自動刪除來源分支。做出選擇之後，請選擇 **Merge pull request (合併提取請求)** 完成合併。  
![\[顯示 CodeCommit 主控台中可用於合併的合併策略的提取請求。\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-merge-squash.png)
   + 如果分支中有無法自動解決的合併衝突，您可以在 CodeCommit 主控台中解決它們，或者您可以使用本機 Git 用戶端來合併分支，然後推送合併。如需詳細資訊，請參閱[解決 AWS CodeCommit 儲存庫中提取請求中的衝突](how-to-resolve-conflict-pull-request.md)。
**注意**  
您一律可以在本機儲存庫中使用 **git merge** 命令並推送變更，以手動合併分支，包括提取請求分支。

如需詳細資訊，請參閱[使用提取請求](pull-requests.md)及[使用核准規則範本](approval-rule-templates.md)。

## 步驟 5：清除
<a name="getting-started-cc-clean-up"></a>

如果您不再需要 CodeCommit 儲存庫，您應該刪除本練習中使用的 CodeCommit 儲存庫和其他資源，這樣您就不會繼續支付儲存空間的費用。

**重要**  
這個操作無法復原。刪除此儲存庫後，您無法再將其複製到任何本機儲存庫或共用儲存庫。您也無法再從任何本機儲存庫或共用儲存庫中提取資料或向其推送資料，或執行任何 Git 操作。  
如果您已為儲存庫設定通知，刪除儲存庫也會刪除為儲存庫建立的 Amazon CloudWatch Events 規則。它不會刪除用作該規則目標的 Amazon SNS 主題。  
如果您已為儲存庫設定觸發條件，刪除儲存庫不會刪除您設定為這些觸發條件目標的 Amazon SNS 主題或 Lambda 函數。如果您已不需要這些資源，務必刪除。如需詳細資訊，請參閱[從儲存庫刪除觸發](how-to-notify-delete.md)。

**刪除 CodeCommit 儲存庫**

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

1. 在 **Repositories (儲存庫)** 中，選擇您要刪除的儲存庫。如果您遵循本主題中的命名慣例，則稱為 **MyDemoRepo**。

1. 在導覽窗格中，選擇**設定**。

1. 在 **Settings (設定)** 頁面的 **Delete repository (刪除儲存庫)** 中，選擇 **Delete repository (刪除儲存庫)**。

1. 輸入 **delete**，然後選擇 **Delete (刪除)**。就會永久刪除這個儲存庫。

## 步驟 6：後續步驟
<a name="getting-started-cc-next"></a>

現在您已熟悉 CodeCommit 及其部分功能，請考慮執行下列動作：
+ 如果您是初次使用 Git 和 CodeCommit，或想要檢閱搭配 CodeCommit 使用 Git 的範例，請繼續教學[Git 和 CodeCommit 入門](getting-started.md)課程。
+ 如果您想要使用 CodeCommit 儲存庫中的其他 ，請參閱 [共用儲存庫](how-to-share-repository.md)。（如果您想要與其他 Amazon Web Services 帳戶中的使用者共用儲存庫，請參閱 [使用 角色設定 AWS CodeCommit 儲存庫的跨帳戶存取權](cross-account.md)。)
+ 如果您想要將儲存庫遷移至 CodeCommit，請遵循中的步驟[遷移至 CodeCommit](how-to-migrate-repository.md)。
+ 如果您想要將儲存庫新增到持續交付管道，請遵循[簡易管道逐步解說](https://docs.aws.amazon.com/codepipeline/latest/userguide/getting-started-cc.html)中的步驟。
+ 如果您想要進一步了解與 CodeCommit 整合的產品和服務，包括社群的範例，請參閱 [產品和服務整合](integrations.md)。

# Git 和 入門 AWS CodeCommit
<a name="getting-started"></a>

如果您是 Git 和 CodeCommit 的新手，本教學課程可協助您了解一些簡單的命令，協助您開始使用。如果您已熟悉 Git，則可以略過此教學課程而直接進入 [開始使用 CodeCommit ](getting-started-cc.md)。

在本教學課程中，您會建立代表 CodeCommit 儲存庫本機複本的儲存庫，我們稱之為本機儲存庫。

建立本機儲存庫之後，您會對其進行一些變更。然後，您將變更傳送到 （推送） CodeCommit 儲存庫。

您也會模擬團隊環境，其中兩個使用者獨立地將變更遞交至其本機儲存庫，並將這些變更推送至 CodeCommit 儲存庫。然後，使用者將變更從 CodeCommit 儲存庫提取到自己的本機儲存庫，以查看其他使用者所做的變更。

您也可以在 CodeCommit 儲存庫中建立分支和標籤，並管理一些存取許可。

完成本教學課程後，您應該具備足夠的核心 Git 和 CodeCommit 概念實務，以將其用於您自己的專案。

完成[先決條件和設定](setting-up.md)，包括：
+ 將許可指派給 IAM 使用者。
+ 設定 CodeCommit 以使用 [HTTPS](setting-up-gc.md)、SSH 或 連線至儲存庫[**git-remote-codecommit**](setting-up-git-remote-codecommit.md)。如需這些選擇的詳細資訊，請參閱[設定 AWS CodeCommit](setting-up.md)。
+  AWS CLI 如果您想要對所有操作使用命令列或終端機，包括建立儲存庫，請設定 。

**Topics**
+ [步驟 1：建立 CodeCommit 儲存庫](#getting-started-create-repo)
+ [步驟 2：建立本機儲存庫](#getting-started-set-up-folders)
+ [步驟 3：建立您的第一個遞交](#getting-started-create-commit)
+ [步驟 4：推送您的第一個遞交](#getting-started-init-repo)
+ [步驟 5：共用 CodeCommit 儲存庫並推送和提取另一個遞交](#getting-started-pull-commits)
+ [步驟 6：建立和共用分支](#getting-started-branching)
+ [步驟 7：建立和共用標籤](#getting-started-tags)
+ [步驟 8：設定存取許可](#getting-started-permissions)
+ [步驟 9：清除](#getting-started-clean-up)

## 步驟 1：建立 CodeCommit 儲存庫
<a name="getting-started-create-repo"></a>

在此步驟中，您會使用 CodeCommit 主控台來建立儲存庫。

如果您已經有要使用的 CodeCommit 儲存庫，則可以略過此步驟。

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

**建立 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 (儲存庫名稱)** 中，輸入儲存庫的名稱 (例如 **MyDemoRepo**)。
**注意**  
儲存庫名稱需區分大小寫且不能超過 100 個字元。如需詳細資訊，請參閱[限制](limits.md#limits-repository-names)。

1. (選用) 在 **Description (描述)** 中，輸入描述 (例如，**My demonstration repository**)。這可協助您和其他使用者識別儲存庫的用途。

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 Reviewer 使用多個機器學習模型來尋找程式碼瑕疵，並在提取請求中自動建議改進和修正。如需詳細資訊，請參閱 Amazon CodeGuru Reviewer 使用者指南。

1. 選擇**建立**。

**注意**  
本教學課程中的其餘步驟會使用 `MyDemoRepo` 做為 CodeCommit 儲存庫的名稱。如果您選擇不同名稱，請在此教學課程中都使用此名稱。

如需有關建立儲存庫的詳細資訊，包括如何從終端機或命令列建立儲存庫，請參閱[建立 儲存庫](how-to-create-repository.md)。

## 步驟 2：建立本機儲存庫
<a name="getting-started-set-up-folders"></a>

在此步驟中，您要在本機電腦上設定本機儲存庫，以連接至您的儲存庫。若要這樣做，請在本機電腦上選取可代表本機儲存庫的目錄。您可以使用 Git 複製並初始化該目錄內空的 CodeCommit 儲存庫副本。然後，指定用於註釋遞交的 Git 使用者名稱和電子郵件地址。

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

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

1. 尋找您要從清單連接的儲存庫並加以選擇。選擇 **Clone URL (複製 URL)**，然後選擇複製和連線至儲存庫時要使用的通訊協定。這會將複製 URL 複製。
   + 如果您使用 Git 登入資料搭配 IAM 使用者或 隨附的登入資料協助程式，請複製 HTTPS URL AWS CLI。
   + 如果您是在本機電腦上使用 **git-remote-codecommit** 命令，請複製 HTTPS (GRC) URL。
   + 如果您搭配 IAM 使用者使用 SSH 公有/私有金鑰對，請複製 SSH URL。
**注意**  
 如果您看到**歡迎**頁面，而不是儲存庫清單，則在您登入 AWS 區域 的 中，沒有與 AWS 您的帳戶相關聯的儲存庫。要建立儲存庫，請參閱 [建立 AWS CodeCommit 儲存庫](how-to-create-repository.md) 或依照 [Git 和 CodeCommit 入門](#getting-started) 教學課程中的步驟。

1. （選用） 建議您將本機 Git 用戶端設定為使用 **main**做為儲存庫預設分支的名稱。這是本指南中所有範例的預設分支所使用的名稱。如果您在主控台中進行第一次遞交，也是 CodeCommit 使用的相同預設分支名稱。執行下列命令，為您的系統全域設定預設分支名稱：

   ```
   git config --global init.defaultBranch main
   ```

   如果您偏好為所有儲存庫使用不同的預設分支名稱，請將 取代**main**為您偏好的名稱。本教學假設您的預設分支已命名為*主要*分支。

   如果您想要對不同的儲存庫使用不同的預設分支名稱，您可以在本機 (**--local**) 而不是全域 () 設定此屬性**--global**。

1. 在終端機或命令提示字元中，使用 **git clone**命令複製儲存庫，並提供您在步驟 3 中複製的複製 URL。您的複製 URL 取決於您使用的通訊協定和組態。例如，如果您使用 HTTPS 搭配 Git 登入資料來複製美國東部 （俄亥俄） 區域中名為 *MyDemoRepo* 的儲存庫：

   ```
   git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
   ```

   如果您是使用 HTTPS 搭配 **git-remote-codecommit**：

   ```
   git clone codecommit://MyDemoRepo my-demo-repo
   ```

   如果您是使用 SSH：

   ```
   git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
   ```
**注意**  
如果您在嘗試複製儲存庫時出現錯誤，您可能尚未完成本機電腦所需的設定作業。如需詳細資訊，請參閱[設定 AWS CodeCommit](setting-up.md)。

## 步驟 3：建立您的第一個遞交
<a name="getting-started-create-commit"></a>

在此步驟中，您會在本機儲存庫中建立第一個遞交。若要這樣做，請在本機儲存庫中建立兩個範例檔案。您可以使用 Git 將變更暫存到本機儲存庫，然後將變更遞交到本機儲存庫。

1. 使用文字編輯器，在您目錄中建立以下兩個範例文字檔案。將檔案命名為 `cat.txt` 和 `dog.txt`：

   ```
   cat.txt
   -------
   The domestic cat (Felis catus or Felis silvestris catus) is a small, usually furry, domesticated, and carnivorous mammal.
   ```

   

   ```
   dog.txt
   -------
   The domestic dog (Canis lupus familiaris) is a canid that is known as man's best friend.
   ```

1. 執行 **git config**，將您的使用者名稱和電子郵件地址 (以 *your-user-name* 和 *your-email-address* 預留位置表示) 新增到本機儲存庫。這可讓您更輕鬆地識別您所做的遞交：

   ```
   git config --local user.name "your-user-name"
   git config --local user.email your-email-address
   ```

1. 如果您在建立本機儲存庫時未全域設定預設分支名稱，請執行下列命令，將預設分支名稱設定為 **main**：

   ```
   git config --local init.defaultBranch main
   ```

1. 執行 **git add** 來暫存變更：

   ```
   git add cat.txt dog.txt
   ```

1. 執行 **git commit** 來遞交變更：

   ```
   git commit -m "Added cat.txt and dog.txt"
   ```
**提示**  
若要查看您剛完成之遞交的詳細資訊，請執行 **git log**。

## 步驟 4：推送您的第一個遞交
<a name="getting-started-init-repo"></a>

在此步驟中，您將遞交從本機儲存庫推送到 CodeCommit 儲存庫。

**git push** 執行 從本機儲存庫 () 中的預設分支，透過 Git 用於 CodeCommit 儲存庫 (`origin`) 的預設遠端名稱推送您的遞交`main`：

```
git push -u origin main
```

**提示**  
將檔案推送至 CodeCommit 儲存庫之後，您可以使用 CodeCommit 主控台來檢視內容。如需詳細資訊，請參閱[瀏覽儲存庫中的檔案](how-to-browse.md)。

## 步驟 5：共用 CodeCommit 儲存庫並推送和提取另一個遞交
<a name="getting-started-pull-commits"></a>

在此步驟中，您會與團隊成員分享 CodeCommit 儲存庫的相關資訊。團隊成員會使用此資訊來取得本機複本、進行一些變更，然後將修改後的本機複本推送至 CodeCommit 儲存庫。然後，將變更從 CodeCommit 儲存庫提取到本機儲存庫。

在此教學課程中，您模擬該同事使用者，在您於[步驟 2](#getting-started-set-up-folders) 建立的目錄以外，讓 Git 再建立另一個目錄。(通常，此目錄位於不同的機器上)。此新目錄是 CodeCommit 儲存庫的副本。您對現有目錄或這個新目錄所做的任何變更彼此無關。識別這些目錄變更的唯一方法是從 CodeCommit 儲存庫提取 。

即使這些目錄在相同的本機機器上，我們仍分別將現有目錄稱為*本機儲存庫*，而將新目錄稱為*共用儲存庫*。

從新目錄中，您可以取得 CodeCommit 儲存庫的個別副本。然後，您可以新增範例檔案、將變更遞交至共用儲存庫，然後將遞交從共用儲存庫推送至 CodeCommit 儲存庫。

最後，您將變更從儲存庫提取到本機儲存庫，然後瀏覽它以查看其他使用者遞交的變更。

1. 切換到 `/tmp` 目錄或 `c:\temp` 目錄。

1. 執行 **git clone**，將儲存庫的副本提取到共用儲存庫：

   針對 HTTPS：

   ```
   git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo shared-demo-repo
   ```

   針對搭配 **git-remote-codecommit** 的 HTTPS：

   ```
   git clone codecommit://MyDemoRepo shared-demo-repo
   ```

   針對 SSH：

   ```
   git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo shared-demo-repo
   ```
**注意**  
當您在 Windows 作業系統上使用 SSH 複製儲存庫時，您可能需要將 SSH 金鑰 ID 新增到連線字串，如下所示：  

   ```
   git clone ssh://Your-SSH-Key-ID@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
   ```
如需詳細資訊，請參閱[Windows 上的 SSH 連線](setting-up-ssh-windows.md)。

   在此命令中， `MyDemoRepo`是 CodeCommit 儲存庫的名稱。 `shared-demo-repo`是 Git 在 `/tmp` 目錄或 `c:\temp`目錄中建立的目錄名稱。在 Git 建立目錄之後，Git 將儲存庫的副本提取到 `shared-demo-repo` 目錄。

1. 切換到 `shared-demo-repo` 目錄：

   ```
   (For Linux, macOS, or Unix) cd /tmp/shared-demo-repo
   (For Windows) cd c:\temp\shared-demo-repo
   ```

1. 執行 **git config** 來新增另一個使用者名稱和電子郵件地址，以預留位置 *other-user-name* 和 *other-email-address* 表示。這可讓您更輕鬆地識別其他使用者所做的遞交：

   ```
   git config --local user.name "other-user-name"
   git config --local user.email other-email-address
   ```

1. 使用文字編輯器，在 `shared-demo-repo` 目錄中建立以下範例文字檔案。將檔案命名為 `horse.txt`：

   ```
   horse.txt
   -------
   The horse (Equus ferus caballus) is one of two extant subspecies of Equus ferus.
   ```

1. 執行 **git add**，將變更暫存到共用儲存庫：

   ```
   git add horse.txt
   ```

1. 執行 **git commit**，將變更遞交到共用儲存庫：

   ```
   git commit -m "Added horse.txt"
   ```

1. **git push** 執行 從本機儲存庫 () 中的預設分支，透過 Git 用於 CodeCommit 儲存庫 (`origin`) 的預設遠端名稱推送初始遞交`main`：

   ```
   git push -u origin main
   ```

1. 切換到本機儲存庫並執行 **git pull** ，將遞交到 CodeCommit 儲存庫的共用儲存庫提取到本機儲存庫。然後執行 **git log**，以查看從共用儲存庫起始的遞交。

## 步驟 6：建立和共用分支
<a name="getting-started-branching"></a>

在此步驟中，您會在本機儲存庫中建立分支，進行一些變更，然後將分支推送到您的 CodeCommit 儲存庫。然後，從 CodeCommit 儲存庫將分支提取至共用儲存庫。

分支可讓您單獨開發不同版本的儲存庫內容 (例如，試用新的軟體功能，而不會影響團隊成員的工作)。當該功能穩定之後，便將分支合併到軟體中更穩定的分支。

您會使用 Git 建立分支，然後將分支指向您所做的第一個遞交。您可以使用 Git 將分支推送至 CodeCommit 儲存庫。然後，切換到共用儲存庫，並使用 Git 將新分支提取到共用的本機儲存庫，並探索分支。

1. 從本機儲存庫中，執行 **git checkout**，指定分支的名稱 （例如 `MyNewBranch`) 和您在本機儲存庫中所做的第一個遞交的 ID。

   如果您不知道遞交 ID，請執行 **git log** 以取得 ID。請確定遞交具有您的使用者名稱和電子郵件地址，而不是其他使用者的使用者名稱和電子郵件地址。這是為了模擬 `main` 是 CodeCommit 儲存庫的穩定版本，而`MyNewBranch`分支適用於一些相對不穩定的新功能：

    

   ```
   git checkout -b MyNewBranch commit-ID
   ```

1. 執行 **git push** 將新的分支從本機儲存庫傳送至 CodeCommit 儲存庫：

   ```
   git push origin MyNewBranch
   ```

1. 現在，將分支提取到共用儲存庫並檢查結果：

   1. 切換到共用儲存庫目錄 (shared-demo-repo)。

   1. 提取新的分支 (**git fetch origin**)。

   1. 確認已提取分支 (**git branch --all** 會顯示儲存庫所有分支的清單)。

   1. 切換到新的分支 (**git checkout MyNewBranch**)。

   1. 確認您已執行 **git status** 或 **git branch** 以切換到 `MyNewBranch` 分支。輸出顯示您所在的分支。在此案例中應該是 `MyNewBranch`。

   1. 檢視分支中的遞交清單 (**git log**)。

   以下是需要呼叫的 Git 命令清單：

   ```
   git fetch origin
   git branch --all
   git checkout MyNewBranch
   git branch or git status
   git log
   ```

1. 切換回 `main` 分支並檢視其遞交清單。Git 命令應如下所示：

    

   ```
   git checkout main
   git log
   ```

1. 切換到本機儲存庫中的`main`分支。您可以執行 **git status** 或 **git branch**。輸出顯示您所在的分支。在此案例中應該是 `main`。Git 命令應如下所示：

    

   ```
   git checkout main
   git branch or git status
   ```

## 步驟 7：建立和共用標籤
<a name="getting-started-tags"></a>

在此步驟中，您會在本機儲存庫中建立兩個標籤，將標籤與遞交建立關聯，然後將標籤推送至 CodeCommit 儲存庫。然後，您將變更從 CodeCommit 儲存庫提取到共用儲存庫。

標籤用於讓遞交 (或分支，甚至是另一個標籤) 有一個人類可讀的名稱。例如，如果想要將遞交加上標籤 `v2.1`，就可以這樣做。遞交、分支或標籤可以擁有任何數量相關聯的標籤數目，但個別標籤只能與一個遞交、分支或標籤相關聯。在此教學課程中，您會將一個遞交加上 `release` 標籤，而將另一個遞交加上 `beta` 標籤。

您會使用 Git 建立標籤，並將 `release` 標籤指向您所做的第一個遞交，而將 `beta` 標籤指向另一個使用者所做的遞交。然後，您可以使用 Git 將標籤推送至 CodeCommit 儲存庫。然後，切換到共用儲存庫，並使用 Git 將標籤提取到共用的本機儲存庫，並探索標籤。

1. 從本機儲存庫中，執行 **git tag**，指定新標籤的名稱 (`release`) 和您在本機儲存庫中所做的第一個遞交 ID。

   如果您不知道遞交 ID，請執行 **git log** 以取得 ID。請確定遞交具有您的使用者名稱和電子郵件地址，而不是其他使用者的使用者名稱和電子郵件地址。這是為了模擬您的遞交是 CodeCommit 儲存庫的穩定版本：

   ```
   git tag release commit-ID
   ```

   執行 **git tag**，將另一個使用者所做的遞交加上 `beta` 標籤。這是為了模擬遞交是一些較不穩定的新功能：

    

   ```
   git tag beta commit-ID
   ```

1. 執行 **git push --tags**將標籤傳送至 CodeCommit 儲存庫。

1. 現在，將標籤提取到共用儲存庫並檢查結果：

   1. 切換到共用儲存庫目錄 (shared-demo-repo)。

   1. 提取新的標籤 (**git fetch origin**)。

   1. 確認已提取標籤 (**git tag** 會顯示儲存庫的標籤清單)。

   1. 檢視每個標籤 (**git log release** 和 **git log beta**) 的相關資訊。

   以下是需要呼叫的 Git 命令清單：

   ```
   git fetch origin
   git tag
   git log release
   git log beta
   ```

1. 也請在本機儲存庫中試用：

   ```
   git log release
   git log beta
   ```

## 步驟 8：設定存取許可
<a name="getting-started-permissions"></a>

在此步驟中，您會授予使用者將共用儲存庫與 CodeCommit 儲存庫同步的許可。此為選用步驟。對於有興趣了解如何在使用者使用 Git 登入資料或 SSH 金鑰對時控制 CodeCommit 儲存庫存取權的使用者，建議與 IAM 使用者搭配使用以存取 CodeCommit 儲存庫。

**注意**  
如果您使用聯合存取、臨時登入資料或 Web 身分提供者，例如 IAM Identity Center，請設定身分提供者的使用者、存取和許可，然後使用 **git-remote-codecommit**。如需詳細資訊，請參閱[AWS CodeCommit 使用 git-remote-codecommit 對 HTTPS 連線的設定步驟](setting-up-git-remote-codecommit.md)及[使用輪換憑證連線至 AWS CodeCommit 儲存庫](temporary-access.md)。

若要這樣做，您可以使用 IAM 主控台來建立使用者，該使用者依預設沒有將共用儲存庫與 CodeCommit 儲存庫同步的許可。您可以執行 **git pull** 來驗證是否如此。如果新使用者沒有同步的許可，則命令不會有作用。然後，返回 IAM 主控台並套用允許使用者使用 的政策**git pull**。同樣地，您可以執行 **git pull** 來驗證是否如此。

此步驟是以您擁有在 Amazon Web Services 帳戶中建立 IAM 使用者的許可編寫的。如果您沒有這些許可，則無法執行此步驟中的程序。直接跳到[步驟 9：清除](#getting-started-clean-up)，以清除您用於此教學課程的資源。

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 開啟 IAM 主控台。

   務必使用您在 [設定 ](setting-up.md) 中使用的相同使用者名稱和密碼。

1. 在導覽窗格中，選擇 **Users (使用者)**，然後選擇 **Create New Users (建立新使用者)**。

1. 在第一個 **Enter User Names (輸入使用者名稱)** 方塊中，輸入範例使用者名稱 (例如，**JaneDoe-CodeCommit**)。選取 **Generate an access key for each user (為每位使用者產生存取金鑰)** 方塊，然後選擇 **Create (建立)**。

1. 選擇 **Show User Security Credentials (顯示使用者安全登入資料)**。記下存取金鑰 ID 和私密存取金鑰，或選擇 **Download Credentials (下載登入資料)**。

1. 遵循 中的指示[對於使用 Git 登入資料的 HTTPS 使用者](setting-up-gc.md)來產生和提供 IAM 使用者的登入資料。

   如果您想要使用 SSH，請按照 [SSH 和 Linux、macOS 或 Unix：設定 Git 和 CodeCommit 的公有和私有金鑰](setting-up-ssh-unixes.md#setting-up-ssh-unixes-keys-unixes)或 [步驟 3：設定 Git 和 CodeCommit 的公有和私有金鑰](setting-up-ssh-windows.md#setting-up-ssh-windows-keys-windows)中的指示，以公有和私有金鑰設定使用者。

1. 執行 **git pull**。應該會出現以下錯誤：

   針對 HTTPS：

    `fatal: unable to access 'https://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403`. 

   針對 SSH：

   `fatal: unable to access 'ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403`. 

   出現此錯誤是因為新使用者沒有將共用儲存庫與 CodeCommit 儲存庫同步的許可。

1. 返回 IAM 主控台。在導覽窗格中，選擇 **Policies (政策)**，然後選擇 **Create Policy (建立政策)**。(出現 **Get Started (開始使用)** 按鈕時先選擇它，然後選擇 **Create Policy (建立政策)**。)

1. 在**建立您自己的政策**旁邊，選擇**選取**。

1. 在 **Policy Name (政策名稱)** 方塊中，輸入名稱 (例如，**CodeCommitAccess-GettingStarted**)。

1. 在**政策文件**方塊中，輸入下列項目，以允許 IAM 使用者從與 IAM 使用者相關聯的任何儲存庫中提取：

    

------
#### [ JSON ]

****  

   ```
   {
     "Version":"2012-10-17",		 	 	 
     "Statement": [
       {
         "Effect": "Allow",
         "Action": [
           "codecommit:GitPull"
         ],
         "Resource": "*"
       }
     ]
   }
   ```

------

    
**提示**  
如果您希望 IAM 使用者能夠將遞交推送到與 IAM 使用者相關聯的任何儲存庫，請改為輸入以下內容：  

****  

   ```
   {
     "Version":"2012-10-17",		 	 	 
     "Statement": [
       {
         "Effect": "Allow",
         "Action": [
           "codecommit:GitPull",
           "codecommit:GitPush"
         ],
         "Resource": "*"
       }
     ]
   }
   ```
如需有關您可以提供給使用者的其他 CodeCommit 動作和資源許可的資訊，請參閱 [的身分驗證和存取控制 AWS CodeCommit](auth-and-access-control.md)。

1. 在導覽窗格中，選擇**使用者** 。

1. 選擇您要連接政策的範例使用者名稱 (例如，**JaneDoe-CodeCommit**)。

1. 選擇**許可**索引標籤。

1. 在 **Managed Policies (受管政策)** 中，選擇 **Attach Policy (連接政策)**。

1. 選取您剛建立的 **CodeCommitAccess-GettingStarted** 政策，然後選擇 **Attach Policy (連接政策)**。

1. 執行 **git pull**。這一次，命令應該有作用，也應該會出現 `Already up-to-date` 訊息。

1. 如果您是使用 HTTPS，請切換到您的原始 Git 登入資料，或者如果您是使用 **git-remote-codecommit**，則請使用您平常使用的描述檔。如需詳細資訊，請參閱[使用 Git 登入資料為 HTTPS 使用者設定](setting-up-gc.md)或[AWS CodeCommit 使用 git-remote-codecommit 對 HTTPS 連線的設定步驟](setting-up-git-remote-codecommit.md)中的指示。

   如果是使用 SSH，請切換到您的原始金鑰。如需詳細資訊，請參閱 [SSH 和 Linux、macOS 或 Unix：設定 Git 和 CodeCommit 的公有和私有金鑰](setting-up-ssh-unixes.md#setting-up-ssh-unixes-keys-unixes) 或 [步驟 3：設定 Git 和 CodeCommit 的公有和私有金鑰](setting-up-ssh-windows.md#setting-up-ssh-windows-keys-windows) 。

您已來到此教學的最後部分。

## 步驟 9：清除
<a name="getting-started-clean-up"></a>

在此步驟中，您會刪除在本教學課程中使用的 CodeCommit 儲存庫，因此不會繼續向您收取儲存空間的費用。

您也可以移除本機電腦上的本機儲存庫和共用儲存庫，因為刪除 CodeCommit 儲存庫之後就不需要這些儲存庫。

**重要**  
刪除此儲存庫後，您將無法將其複製到任何本機儲存庫或共用儲存庫。您也無法從任何本機儲存庫或共用儲存庫中提取資料，或將資料推送至其中。這個操作無法復原。

### 刪除 CodeCommit 儲存庫 （主控台）
<a name="getting-started-clean-up-console"></a>

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

1. 在**儀表板**頁面的儲存庫清單中，選擇 **MyDemoRepo**。

1. 在導覽窗格中，選擇**設定**。

1. 在 **Settings (設定)** 頁面的 **Delete repository (刪除儲存庫)** 中，選擇 **Delete repository (刪除儲存庫)**。

1. 在 **Type the name of the repository to confirm deletion (輸入儲存庫名稱以確認刪除)** 旁的方塊中，輸入 **MyDemoRepo**，然後選擇 **Delete (刪除)**。

### 刪除 CodeCommit 儲存庫 (AWS CLI)
<a name="getting-started-clean-up-cli"></a>

執行 [delete-repository](how-to-delete-repository.md#how-to-delete-repository-cli) 命令：

```
aws codecommit delete-repository --repository-name MyDemoRepo
```

### 刪除本機儲存庫和共用儲存庫
<a name="getting-started-delete-repos"></a>

針對 Linux、macOS 或 Unix：

```
cd /tmp
rm -rf /tmp/my-demo-repo
rm -rf /tmp/shared-demo-repo
```

針對 Windows：

```
cd c:\temp
rd /s /q c:\temp\my-demo-repo
rd /s /q c:\temp\shared-demo-repo
```