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

# 連線至 AWS CodeCommit 儲存庫
<a name="how-to-connect"></a>

當您第一次連線到 CodeCommit 儲存庫時，通常會將其內容複製到本機電腦。您也可以直接從 CodeCommit 主控台將[檔案新增至](how-to-create-file.md#how-to-create-file-console)和[編輯儲存庫中的檔案](how-to-edit-file.md#how-to-edit-file-console)。或者，如果您已有本機儲存庫，您可以將 CodeCommit 儲存庫新增為遠端儲存庫。本主題提供連線至 CodeCommit 儲存庫的指示。如果您想要將現有的儲存庫遷移至 CodeCommit，請參閱 [遷移至 CodeCommit](how-to-migrate-repository.md)。

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

**Topics**
+ [連線至 CodeCommit 儲存庫的先決條件](#how-to-connect-prerequisites)
+ [透過複製儲存庫來連線至 CodeCommit 儲存庫](#how-to-connect-http)
+ [將本機儲存庫連線至 CodeCommit 儲存庫](#how-to-connect-local)

## 連線至 CodeCommit 儲存庫的先決條件
<a name="how-to-connect-prerequisites"></a>

在複製 CodeCommit 儲存庫或將本機儲存庫連線至 CodeCommit 儲存庫之前：
+ 您必須使用連線至 CodeCommit 所需的軟體和設定來設定本機電腦。這包括安裝和設定 Git。如需詳細資訊，請參閱[設定 ](setting-up.md)及[Git 和 入門 AWS CodeCommit](getting-started.md)。
+ 您必須擁有要連線之 CodeCommit 儲存庫的複製 URL。如需詳細資訊，請參閱[檢視儲存庫詳細資訊](how-to-view-repository-details.md)。

  如果您尚未建立 CodeCommit 儲存庫，請遵循 中的指示[建立 儲存庫](how-to-create-repository.md)，複製 CodeCommit 儲存庫的複製 URL，然後返回此頁面。

  如果您有 CodeCommit 儲存庫，但不知道其名稱，請遵循 中的指示[檢視儲存庫詳細資訊](how-to-view-repository-details.md)。
+ 您的本機電腦上必須有位置，才能儲存您連線之 CodeCommit 儲存庫的本機副本。(CodeCommit 儲存庫的此本機複本稱為*本機儲存庫*。) 然後從該位置切換到和執行 Git 命令。例如，如果您為了測試目的而進行暫時複製，您可以使用 `/tmp`（適用於 Linux、macOS 或 Unix) 或 `c:\temp`（適用於 Windows)。這是用於這些範例中的目錄路徑。
**注意**  
您可以使用您要的任何目錄。如果您要複製長期使用的儲存庫，請考慮從工作目錄建立複製，而非用於暫時檔案的複製。如果是使用 `/tmp` 或 `c:\temp` 以外的目錄，當您依照這些指示時，請務必將該目錄以我們的目錄取代。

## 透過複製儲存庫來連線至 CodeCommit 儲存庫
<a name="how-to-connect-http"></a>

如果您還沒有本機儲存庫，請依照此程序中的步驟將 CodeCommit 儲存庫複製到本機電腦。

1. 完成必要條件，包括[設定 ](setting-up.md)。
**重要**  
如果尚未完成設定，您無法連接到或複製儲存庫。

1. 從 `/tmp` 目錄或 `c:\temp` 目錄，使用 Git 來執行 **clone** 命令。下列範例示範如何在美國東部 （俄亥俄） 區域中複製名為 {{MyDemoRepo}} 的儲存庫。

   針對使用 [Git 登入資料](setting-up-gc.md) 或 AWS CLI隨附的登入資料協助程式的 HTTPS：

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

   對於使用 的 HTTPS**[git-remote-codecommit](setting-up-git-remote-codecommit.md)**，假設預設設定檔並在 AWS 區域 中設定 AWS CLI：

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

   針對 SSH：

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

   在此範例中， `git-codecommit.us-east-2.amazonaws.com`是儲存庫所在的美國東部 （俄亥俄） 區域的 Git 連接點、`MyDemoRepo`代表 CodeCommit 儲存庫的名稱，以及`my-demo-repo`代表 Git 在 `/tmp` 目錄或 `c:\temp`目錄中建立的目錄名稱。如需支援 CodeCommit AWS 區域 的 和這些連線的 Git 連線的詳細資訊 AWS 區域，請參閱 [區域和 Git 連線端點](regions.md)。
**注意**  
當您在 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)及[疑難排解](troubleshooting.md)。

   Git 建立目錄後，會將 CodeCommit 儲存庫的副本下拉到新建立的目錄中。

   如果 CodeCommit 儲存庫是新的或其他空白的，您會看到複製空白儲存庫的訊息。這是預期的行為。
**注意**  
如果您收到 Git 找不到 CodeCommit 儲存庫或您沒有連線至 CodeCommit 儲存庫的許可的錯誤，請確定您已完成[先決條件](setting-up.md)，包括將許可指派給 IAM 使用者，以及在本機電腦上設定 Git 和 CodeCommit 的 IAM 使用者憑證。同時，請確定您已指定正確的儲存庫名稱。

成功將本機儲存庫連線至 CodeCommit 儲存庫後，您現在可以開始從本機儲存庫執行 Git 命令，以建立遞交、分支和標籤，並推送至 CodeCommit 儲存庫並從中提取。

## 將本機儲存庫連線至 CodeCommit 儲存庫
<a name="how-to-connect-local"></a>

如果您已經有本機儲存庫，並想要新增 CodeCommit 儲存庫做為遠端儲存庫，請完成以下步驟。如果您已經有遠端儲存庫，並想要將遞交推送到 CodeCommit 和其他遠端儲存庫，請遵循中的步驟[將遞交推送至兩個儲存庫](how-to-mirror-repo-pushes.md)。

1. 完成[先決條件](#how-to-connect-prerequisites)。

1. 從命令提示字元或終端機，切換到本機儲存庫目錄並執行 **git remote add**命令，將 CodeCommit 儲存庫新增為本機儲存庫的遠端儲存庫。

   例如，下列命令會將遠端暱稱新增至 **origin** https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo：//：

   針對 HTTPS：

   ```
   git remote add origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo
   ```

   針對 SSH：

    

   ```
   git remote add origin ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo
   ```

   此命令不會傳回任何結果。

1. 若要驗證您已將 CodeCommit 儲存庫新增為本機儲存庫的遠端，請執行 **git remote -v**命令，該命令應建立類似以下的輸出：

   針對 HTTPS：

   ```
   origin  https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (fetch)      
   origin  https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (push)
   ```

   針對 SSH：

    

   ```
   origin  ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (fetch)       
   origin  ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (push)
   ```

成功將本機儲存庫連線至 CodeCommit 儲存庫後，您就可以開始從本機儲存庫執行 Git 命令，以建立遞交、分支和標籤，以及推送至 CodeCommit 儲存庫並從中提取。