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

# 入門 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)。