AWS CodeCommit
用户指南 (API 版本 2015-04-13)

将 AWS Cloud9 与 AWS CodeCommit 集成

您可以使用 AWS Cloud9 在 CodeCommit 存储库中进行代码更改。AWS Cloud9 包含一套工具,可用于编写代码以及构建、运行、测试、调试和发布软件。您可以克隆现有存储库、创建存储库、向存储库提交和推送代码更改等,所有这些操作都在 AWS Cloud9 EC2 开发环境中完成。AWS Cloud9 EC2 开发环境通常已使用 AWS CLI、Amazon EC2 角色和 Git 进行预配置,因此,在大多数情况下,您可以运行几条简单命令并开始与存储库进行交互。

要将 AWS Cloud9 与 CodeCommit 结合使用,您需要:

步骤 1:创建 AWS Cloud9 开发环境

AWS Cloud9 将在 Amazon EC2 实例上托管开发环境。这是最简单的集成方法,因为您可以使用实例的 AWS 托管临时凭证来连接到您的 CodeCommit 存储库。如果您想改用您自己的服务器,请参阅 AWS Cloud9 用户指南

创建 AWS Cloud9 环境

  1. 以您配置的 IAM 用户身份登录到 AWS 并打开 AWS Cloud9 控制台。

  2. 在 AWS Cloud9 控制台中,选择创建环境

  3. 步骤 1: 命名环境中,输入环境的名称和可选描述,然后选择下一步

  4. 步骤 2: 配置设置中,配置您的环境,如下所示:

    • Environment type 中,选择 Create a new instance for environment (EC2)

    • Instance type 中,为开发环境选择适当的实例类型。例如,如果您只探索该服务,则可以选择默认值 t2.micro。如果您打算将此环境用于开发工作,请选择更大的实例类型。

    • 接受其他默认设置(除非您出于特定原因不这样做(例如,您的组织使用特定 VPC,或者您的 AWS 账户未配置任何 VPC)),然后选择下一步

  5. 步骤 3: 审核 中,审查您的设置。如果您需要进行任何更改,请选择 Previous step。否则,请选择 Create environment

    创建一个环境,首次连接到此环境需要几分钟的时间。如果连接所花时间似乎太长,请参阅 AWS Cloud9用户指南 中的疑难解答

  6. 在连接到您的环境后,请检查是否已安装 Git,并通过在终端窗口中运行 git --version 命令查看它是否为受支持的版本。

    
                        验证 Git 是否已安装且为 AWS Cloud9 开发环境中支持的版本。

    如果未安装 Git,或者 Git 不是受支持的版本,请安装受支持的版本。CodeCommit 支持 Git 1.7.9 以及更高版本。 要安装 Git,建议您访问 Git 下载等网站。

    提示

    根据环境的操作系统,您也许能够使用带 sudo 选项的 yum 命令安装更新,包括 Git。例如,管理命令序列可能与以下三条命令类似:

    sudo yum -y update sudo yum -y install git git --version
  7. 通过运行 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

  2. 在终端上,运行以下命令来配置 AWS CLI 凭证辅助程序以进行 HTTPS 连接:

    git config --global credential.helper '!aws codecommit credential-helper $@' git config --global credential.UseHttpPath true

    提示

    该凭证辅助程序将为开发环境使用默认 Amazon EC2 实例角色。如果您打算使用开发环境连接到未在 CodeCommit 中托管的存储库,请配置与这些存储库的 SSH 连接,或配置本地 .gitconfig 文件以在连接到其他存储库时使用备用凭证管理系统。有关更多信息,请参阅 Git 网站上的 Git 工具 - 凭证存储

步骤 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

    提示

    在 CodeCommit 控制台中,您可以在存储库中和存储库的代码页面上的克隆 URL 信息中找到存储库的克隆 URL。

  2. 在克隆完成后,在侧面导航中展开存储库的文件夹,然后选择要打开的文件以进行编辑。或者,选择文件,然后选择新文件以创建文件。

  3. 在完成文件的编辑和创建后,请在终端窗口中,将目录更改为您的克隆存储库,然后提交和推送更改。例如,如果您添加了一个名为 MyFile.py 的新文件,则:

    cd MyDemoRepo git commit -a MyFile.py git commit -m "Added a new file with some code improvements" git push

后续步骤

有关更多信息,请参阅 AWS Cloud9 用户指南。有关将 Git 与 CodeCommit 结合使用的更多信息,请参阅 Git 与 AWS CodeCommit 教程