本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 使用 Git 凭证从开发工具设置连接
在 IAM 控制台中为 AWS CodeCommit 配置 Git 凭证后，您可以在支持 Git 凭证的任何开发工具中使用这些凭证。例如，您可以在 AWS Cloud9、Visual Studio、Xcode、IntelliJ 或集成了 Git 凭证的任意集成式开发环境（IDE）中配置对您的 CodeCommit 存储库的访问。配置访问后，您可以编辑代码、提交更改并从 IDE 或其他开发工具直接推送。
**注意**
如果您使用联合访问、临时凭证或 Web 身份提供程序访问 CodeCommit 存储库，则无法使用 Git 凭证。我们建议您使用 `git-remote-codecommit` 命令设置本地计算机。但是，并非所有 IDE 都与 Git 远程辅助程序（如 **git-remote-codecommit**）完全兼容。如果遇到问题，请参阅[故障排除 git-remote-codecommit和 AWS CodeCommit](troubleshooting-grc.md)。
**Topics**
+ [AWS Cloud9 与集成 AWS CodeCommit](setting-up-ide-c9.md)
+ [将 Visual Studio 与 AWS CodeCommit 集成](setting-up-ide-vs.md)
在 IDE 或开发工具提示输入用于连接 CodeCommit 存储库的用户名和密码时，请提供您在 IAM 中创建的**用户名**和**密码**的 Git 凭证。
有关 AWS 区域和 CodeCommit 终端节点的更多信息，请参阅[区域和 Git 连接端点](regions.md)。
您可能还会看到操作系统提示存储用户名和密码。例如，在 Windows 中，应如下所示提供 Git 凭证：
![\[Windows 中的安全提示\]](http://docs.aws.amazon.com/zh_cn/codecommit/latest/userguide/images/codecommit-ide-vs2.png)
有关为特定软件程序或开发工具配置 Git 凭证的信息，请参阅产品文档。
下面是不全面的 IDE 列表。单独提供这些链接以帮助您详细了解这些工具。AWS 对其中任何主题的内容不承担责任。
+ [AWS Cloud9](setting-up-ide-c9.md)
![\[在 AWS Cloud9 中克隆存储库。\]](http://docs.aws.amazon.com/zh_cn/codecommit/latest/userguide/images/codecommit-ide-c9-clone.png)
+ [Visual Studio](https://www.visualstudio.com/en-us/docs/git/tutorial/creatingrepo#clone-an-existing-git-repo)
或者，安装 AWS Toolkit for Visual Studio。有关更多信息，请参阅 [将 Visual Studio 与 AWS CodeCommit 集成](setting-up-ide-vs.md)。
![\[在 Visual Studio 中克隆存储库。\]](http://docs.aws.amazon.com/zh_cn/codecommit/latest/userguide/images/codecommit-ide-vs1.png)
+ [XCode](https://developer.apple.com/library/content/documentation/IDEs/Conceptual/xcode_guide-continuous_integration/PublishYourCodetoaSourceRepository.html)
# AWS Cloud9 与集成 AWS CodeCommit
您可以使用 AWS Cloud9 对 CodeCommit 存储库中的代码进行更改。 AWS Cloud9 包含一系列工具，可用于编写代码以及构建、运行、测试、调试和发布软件。您可以从 AWS Cloud9 EC2 开发环境中克隆现有存储库、创建存储库、提交代码更改并将其推送到存储库等。 AWS Cloud9 EC2 开发环境通常预先配置有 AWS CLI、Amazon EC2 角色和 Git，因此在大多数情况下，您可以运行一些简单的命令并开始与存储库交互。
要 AWS Cloud9 与一起使用 CodeCommit，您需要满足以下条件：
+ 在亚马逊 Linux 上运行的 AWS Cloud9 EC2 开发环境。
+ AWS Cloud9 IDE 将在 Web 浏览器中打开。
+ 具有其中一个 CodeCommit 托管策略和一个托 AWS Cloud9 管策略的 IAM 用户。
有关更多信息，请参阅[AWS 的托管策略 CodeCommit](security-iam-awsmanpol.md)和[了解并获取您的安全凭证](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html)。
**注意**
本主题介绍如何设置与 Internet 的集成 CodeCommit 以及 AWS Cloud9 通过互联网进行常规访问的集成。您可以在隔离的环境 AWS Cloud9 中设置访问权限 CodeCommit 和访问权限，但这需要额外的步骤。有关更多信息，请参阅:
[AWS CodeCommit 与接口 VPC 终端节点一起使用](codecommit-and-interface-VPC.md)
[使用访问无入口的 Amazon EC2 实例 AWS Systems Manager](https://docs.aws.amazon.com/cloud9/latest/user-guide/ec2-ssm.html)
[使用共享环境](https://docs.aws.amazon.com/cloud9/latest/user-guide/share-environment.html)
[与其他账户共享 VPC](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-sharing.html)
[博客文章：隔离对环境的网络访问 AWS Cloud9](https://aws.amazon.com/blogs/security/isolating-network-access-to-your-aws-cloud9-environments/)
**Topics**
+ [步骤 1：创建 AWS Cloud9 开发环境](#setting-up-ide-c9-connect)
+ [步骤 2：在您的 AWS Cloud9 EC2 开发环境中配置 AWS CLI 凭证助手](#setting-up-ide-c9-credentials)
+ [步骤 3：将 CodeCommit 存储库克隆到您 AWS Cloud9 的 EC2 开发环境中](#setting-up-ide-c9-checkout)
+ [后续步骤](#setting-up-ide-c9-next)
## 步骤 1：创建 AWS Cloud9 开发环境
AWS Cloud9 将您的开发环境托管在 Amazon EC2 实例上。这是最简单的集成方式，因为您可以使用实例的 AWS 托管临时证书连接到您的 CodeCommit 存储库。如果您想改用自己的服务器，请参阅 [AWS Cloud9 用户指南](https://docs.aws.amazon.com/cloud9/latest/user-guide/)。
**创建 AWS Cloud9 环境**
1. 以 AWS 您配置的 IAM 用户身份登录并打开 AWS Cloud9 控制台。
1. 在 AWS Cloud9 控制台中，选择**创建环境**。
1. 在**步骤 1: 命名环境**中，输入环境的名称和可选描述，然后选择**下一步**。
1. 在**步骤 2: 配置设置**中，配置您的环境，如下所示：
+ 在 **Environment type** 中，选择 **Create a new instance for environment (EC2)**。
+ 在 **Instance type** 中，为开发环境选择适当的实例类型。例如，如果您只探索该服务，则可以选择默认值 t2.micro。如果您打算将此环境用于开发工作，请选择更大的实例类型。
+ 除非您有理由选择其他默认设置（例如，您的组织使用特定的 VPC，或者您的 Amazon Web Services 账户未 VPCs 配置任何设置），然后选择**下一步**。
1. 在**步骤 3: 审核** 中，审查您的设置。如果您需要进行任何更改，请选择 **Previous step**。否则，请选择 **Create environment**。
创建一个环境，首次连接到此环境需要几分钟的时间。如果连接所花时间似乎太长，请参阅**《AWS Cloud9 用户指南》中的[故障排除](https://docs.aws.amazon.com/cloud9/latest/user-guide/troubleshooting.html)。
1. 在连接到您的环境后，请检查是否已安装 Git，并通过在终端窗口中运行 **git --version** 命令查看它是否为受支持的版本。
如果未安装 Git，或者它不是支持的版本，请安装支持的版本。 CodeCommit 支持 Git 版本 1.7.9 及更高版本。Git 版本 2.28 支持为初始提交配置分支名称。我们建议使用最新版本的 Git。要安装 Git，建议您访问 [Git 下载](http://git-scm.com/downloads)等网站。
**提示**
根据环境的操作系统，您也许能够使用带 **sudo** 选项的 **yum** 命令安装更新，包括 Git。例如，管理命令序列可能与以下三条命令类似：
```
sudo yum -y update
sudo yum -y install git
git --version
```
1. 通过运行 **git config** 命令配置要与 Git 提交关联的用户名和电子邮件。例如：
```
git config --global user.name "Mary Major"
git config --global user.email mary.major@example.com
```
## 步骤 2：在您的 AWS Cloud9 EC2 开发环境中配置 AWS CLI 凭证助手
创建 AWS Cloud9 环境后，您可以配置 AWS CLI 凭证助手来管理 CodeCommit 存储库连接的凭据。 AWS Cloud9 开发环境附带与您的 IAM 用户关联的 AWS 托管临时证书。您可以将这些凭据与凭证助手一起使用。 AWS CLI
1. 打开终端窗口并运行以下命令来验证是否安装了 AWS CLI ：
```
aws --version
```
如果成功，此命令将返回当前安装的版本的 AWS CLI。要将旧版本的升级 AWS CLI 到最新版本，请参阅[安装 AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)。
1. 在终端上，运行以下命令为 HTTPS 连接配置 AWS CLI 凭证助手：
```
git config --global credential.helper '!aws codecommit credential-helper $@'
git config --global credential.UseHttpPath true
```
**提示**
该凭证助手将为开发环境使用默认的 Amazon EC2 实例角色。如果您打算使用开发环境连接到未托管在中的 CodeCommit存储库，请配置与这些存储库的 SSH 连接，或者将本地`.gitconfig`文件配置为在连接到其他存储库时使用备用凭证管理系统。有关更多信息，请参阅 Git 网站上的 [Git 工具 - 凭证存储](https://git-scm.com/book/en/v2/Git-Tools-Credential-Storage)。
## 步骤 3：将 CodeCommit 存储库克隆到您 AWS Cloud9 的 EC2 开发环境中
配置 AWS CLI 凭证助手后，您可以将 CodeCommit存储库克隆到该助手上。然后，您便可以开始使用代码。
1. 在终端，运行 **git clone** 命令，并指定要克隆的存储库的 HTTPS 克隆 URL。例如，如果您要克隆一个名 MyDemoRepo 为美国东部（俄亥俄州）地区的存储库，则需要输入：
```
git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo
```
**提示**
通过选择 “克隆 URL”，可以在 CodeCommit 控制台中找到仓库的**克隆 URL**。
1. 在克隆完成后，在侧面导航中展开存储库的文件夹，然后选择要打开的文件以进行编辑。或者，选择**文件**，然后选择**新文件**以创建文件。
1. 在完成文件的编辑和创建后，请在终端窗口中，将目录更改为您的克隆存储库，然后提交和推送更改。例如，如果您添加了一个名为*MyFile.py*：的新文件
```
cd MyDemoRepo
git commit -a MyFile.py
git commit -m "Added a new file with some code improvements"
git push
```
## 后续步骤
有关更多信息，请参阅[AWS Cloud9 用户指南](https://docs.aws.amazon.com/cloud9/latest/user-guide/welcome.html)和[CodeCommit 示例 AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/sample-codecommit.html)。有关将 Git 与配合使用的更多信息 CodeCommit，请参阅[Git 入门和 AWS CodeCommit](getting-started.md)。
# 将 Visual Studio 与 AWS CodeCommit 集成
您可以使用 Visual Studio 在 CodeCommit 存储库中进行代码更改。AWS Toolkit for Visual Studio 现在包含的功能可让您在 Visual Studio 中工作时更轻松、更方便地使用 CodeCommit。Toolkit for Visual Studio 集成可以与 Git 凭证和 IAM 用户结合使用。您可以克隆现有存储库、创建存储库、向存储库提交和推送代码更改等。
**重要**
Toolkit for Visual Studio 只能在 Windows 操作系统上安装。如果您要寻找有关使用 Visual Studio Code 的信息，请参阅 [AWS Toolkit for Visual Studio Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html)。
如果您之前使用过 Toolkit for Visual Studio，可能已经熟悉如何设置包含访问密钥和秘密密钥的 AWS 凭证配置文件。凭证配置文件在 Toolkit for Visual Studio 中用于启用对 AWS 服务 API 的调用（例如，供 Amazon S3 列出桶或供 CodeCommit 列出存储库）。要向 CodeCommit 存储库中拉取和推送代码，您还需要 Git 凭证。如果您没有 Git 凭证，Toolkit for Visual Studio 可以为您生成并应用这些凭证。这可为您节省大量时间。
要使用 Visual Studio 和 CodeCommit，您需要：
+ 已配置一组有效凭证（访问密钥和秘密密钥）的 IAM 用户。此 IAM 用户还应该满足以下条件：
已对其应用某个 CodeCommit 托管策略以及 IAMSelfManageServiceSpecificCredentials 托管策略。
或
如果 IAM 用户已配置 Git 凭证，则需要一个 CodeCommit 托管策略或等效权限。
有关更多信息，请参阅[AWS 的托管策略 CodeCommit](security-iam-awsmanpol.md)和[了解并获取您的安全凭证](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html)。
+ AWS Toolkit for Visual Studio 安装在您已安装了 Visual Studio 的计算机上。有关更多信息，请参阅[设置 AWS Toolkit for Visual Studio](https://docs.aws.amazon.com/AWSToolkitVS/latest/UserGuide/getting-set-up.html)。
有关使用 AWS Toolkit for Visual Studio 和 CodeCommit 的更多信息，请参阅 《Toolkit for Visual Studio 用户指南》中的[使用 AWS CodeCommit 和 Visual Studio Team Explorer](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/using-aws-codecommit-with-team-explorer.html)。**