本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Connect 连接到 Amazon 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://www.amazonaws.cn/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 入门和 Amazon 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)的 HTTPS 或 Amazon CLI随附的凭证辅助程序：

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

   对于使用 **[git-remote-codecommit](setting-up-git-remote-codecommit.md)** 的 HTTPS，假设在 Amazon CLI中配置了默认配置文件和 Amazon Web Services 区域 ：

   ```
   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 以及这些支持 Amazon Web Services 区域 的 Git 连接的更多信息 Amazon Web Services 区域，请参阅[区域和 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. 在命令提示符或终端中，切换到本地 repo 目录并运行**git remote add**命令将 CodeCommit 存储库添加为本地存储库的远程存储库。

   例如，以下命令将昵称的遥控器添加到 m https://git-codecom it.us-east-2.amazona **origin** ws。 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