教程：使用 GitHub 源代码库创建项目 - AWS CodeStar
步骤 1：创建项目并创建您的 GitHub 存储库步骤 2：查看源代码步骤 3：创建 GitHub 拉取请求

2024 年 7 月 31 日，亚马逊 Web Services (AWS) 将停止支持创建和查看 AWS CodeStar 项目。2024 年 7 月 31 日之后，您将无法再访问 AWS CodeStar 控制台或创建新项目。但是，由 AWS CodeStar创建的 AWS 资源（包括您的源存储库、管道和构建）将不受此更改的影响，并将继续运行。 AWS CodeStar 此次停用不会影响连接和 AWS CodeStar 通知。

 

如果您想跟踪工作、开发代码以及构建、测试和部署应用程序，Amazon CodeCatalyst 提供了简化的入门流程和其他功能来管理您的软件项目。详细了解 Amazon 的功能和定价 CodeCatalyst。

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

教程：使用 GitHub 源代码库创建项目

使用 AWS CodeStar，您可以设置存储库，以便与项目团队一起创建、审阅和合并拉取请求。

在本教程中，您将创建一个项目，其中包含 GitHub 存储库中的示例 Web 应用程序源代码、用于部署更改的管道以及在云中托管应用程序的 EC2 实例。项目创建完成后，本教程将向您展示如何创建和合并 GitHub 拉取请求，以更改您的 Web 应用程序的主页。

步骤 1：创建项目并创建您的 GitHub 存储库

在此步骤中，使用控制台创建项目并创建与新 GitHub 存储库的连接。要访问您的 GitHub 存储库，您需要创建一个 AWS CodeStar 用于管理 GitHub 授权的连接资源。创建项目后，系统会为您配置项目的其他资源。

  1. 登录 AWS Management Console，然后通过以下网址打开 AWS CodeStar 控制台：https://console.aws.amazon.com/codestar/。

  2. 选择要在其中创建项目及其资源的 AWS 区域。

  3. 在 AWS CodeStar 页面上，选择创建项目。

  4. 在选择项目模板页面上，选中 Web 应用程序、Node.js 和 Amazon EC2 复选框。随后，从可用于此选项集的模板中进行选择。

    有关更多信息，请参阅AWS CodeStar 项目模板。

  5. 选择下一步。

  6. 对于项目名称，输入项目的名称（例如，MyTeamProject）。如果您使用其他名称，请确保在本教程中通篇使用它。

  7. 在项目存储库下，选择 GitHub。

  8. 如果您选择 GitHub，则需要选择或创建连接资源。如果您已有连接，请在搜索栏中选择该连接。否则，您将在此处创建一个新连接。选择连接到 GitHub。

    创建连接页面随即显示。

    注意

    要创建连接，您必须拥有 GitHub 账户。您必须是组织所有者才能为组织创建连接。

    1. 在创建 GitHub 应用程序连接的连接名称中，输入连接的名称。选择连接到 GitHub。

      连接到 GitHub 页面将出现，并显示 GitHub 应用程序字段。

    2. 在 GitHub 应用程序下，选择一个应用程序安装或选择安装新应用程序来创建一个应用程序安装。

      注意

      您可以为与特定提供程序的所有连接安装一个应用程序。如果您已经安装了 AWS Connector for GitHub 应用程序，选择它并跳过此步骤。

    3. 在安装 AWS Connector for GitHub 页面中，选择要在其中安装应用程序的账户。

      注意

      如果您之前已安装了应用程序，则可以选择配置，继续进入应用程序安装的修改页面，也可以使用后退按钮返回到控制台。

    4. 如果显示确认密码以继续页面，请输入您的 GitHub 密码，然后选择登录。

    5. 在安装 AWS Connector for GitHub 页面中，保留所有默认设置，然后选择安装。

    6. 在连接到 GitHub 页面上，新安装的连接 ID 将显示在 GitHub 应用程序中。

      成功创建连接后，在 CodeStar“创建项目”页面中，将显示准备连接消息。

      注意

      您可以在“开发人员工具”控制台的“设置”下查看连接。有关更多信息，请参阅开始使用连接。

      显示已完成的 GitHub 存储库连接设置的控制台屏幕截图。

    7. 对于存储库所有者，请选择 GitHub 组织或您的个人 GitHub 账户。

    8. 对于存储库名称，请接受默认的 GitHub 存储库名称，或输入其他名称。

    9. 选择 公共或私有。

      注意

      如果您想使用 AWS Cloud9 作为开发环境，则必须选择一个公共存储库。

    10. （可选）对于存储库描述，请为 GitHub 存储库输入描述。

  9. 如果您的项目已部署到 Amazon EC2 实例并且您想进行更改，请在 Amazon EC2 配置中配置您的 Amazon EC2 实例。例如，您可以从项目的可用实例类型中进行选择。

    在密钥对中，选择在 步骤 4：为 AWS CodeStar 项目创建 Amazon EC2 密钥对 创建的 Amazon EC2 密钥对。选择我确认我有权访问私钥文件。

  10. 选择下一步。

  11. 查看资源和配置详细信息。

  12. 选择 Next 或 Create project。（显示的选择取决于您的项目模板。）

    等待几分钟，项目会创建完毕。

  13. 创建项目后，选择查看应用程序以查看您的 Web 应用程序。

步骤 2：查看源代码

在此步骤中，您将查看源代码和可用于源存储库的工具。

  1. 在项目的导航栏中，选择存储库。

    要在 GitHub 中查看提交列表，请选择查看提交。这将在 GitHub 中打开您的提交历史记录。

    要查看问题，请选择项目的问题选项卡。要在 GitHub 中创建新问题，请选择创建 GitHub 问题。这将在 GitHub 中打开您的存储库问题表单。

  2. 在存储库选项卡下，选择存储库名称下的链接，您的项目存储库将在新的选项卡或窗口中打开。此存储库包含您项目的源代码。

步骤 3：创建 GitHub 拉取请求

在此步骤中，您将对源代码进行细微更改并创建拉取请求。

  1. 在 GitHub 中，在存储库中创建一个新的功能分支。选择主分支下拉字段，然后在名为 feature-branch 的字段中输入新的分支。选择创建新分支。该分支已为您创建并签出。

  2. 在 GitHub 中，在 feature-branch 分支中进行更改。打开公共文件夹并打开 index.html 文件。

  3. 如要在 GitHub 中创建拉取请求，请在 AWS CodeStar 控制台的拉取请求下，选择创建拉取请求。这将在 GitHub 中打开您的存储库拉取请求表单。在 GitHub 中，选择铅笔图标来编辑文件。

    出现 Congratulations! 之后，添加字符串 Well done, <name>! 并将 <name> 替换为您的名字。选择提交更改。此时更改已提交到您的功能分支。

  4. 在 AWS CodeStar 控制台中，选择您的项目。选择存储库选项卡。在“拉取请求”中，选择创建拉取请求。

    表格将在 GitHub 中打开。将主分支留在基础分支中。在比较对象中，选择您的功能分支。查看差异。

  5. 在 GitHub 中，选择创建拉取请求。系统将创建一个名为 Update index.html 的拉取请求。

  6. 在 AWS CodeStar 控制台中，查看新的拉取请求。选择合并更改，将更改提交到存储库，并将拉取请求与存储库的主分支合并。

  7. 返回 AWS CodeStar 中的项目并查看管道页面。现在您应看到管道正在部署。

  8. 创建项目后，选择查看应用程序以查看您的 Web 应用程序。