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

# AWS Cloud9 与集成 AWS CodeCommit
<a name="setting-up-ide-c9"></a>

您可以使用 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 开发环境
<a name="setting-up-ide-c9-connect"></a>

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 凭证助手
<a name="setting-up-ide-c9-credentials"></a>

创建 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 开发环境中
<a name="setting-up-ide-c9-checkout"></a>

配置 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
   ```

## 后续步骤
<a name="setting-up-ide-c9-next"></a>

有关更多信息，请参阅[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)。