教程:从一个空项目开始,然后手动添加资源 - Amazon CodeCatalyst

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

教程:从一个空项目开始,然后手动添加资源

通过在创建项目时选择空项目蓝图,可以创建一个内部不含任何预定义资源的空项目。创建空项目后,您可以根据项目需求创建和添加资源。由于在不使用蓝图的情况下创建的项目在创建时为空,因而需要有更多有关创建和配置 CodeCatalyst 资源的知识,才能开始使用此选项。

先决条件

要创建空项目,必须为您分配空间管理员高级用户角色。如果这是您首次登录 CodeCatalyst,请参阅设置并登录 CodeCatalyst

创建空项目

要协同工作,首先要创建项目。如果您想创建自己的资源(例如源存储库和工作流),则可以从一个空项目开始。

创建空项目
  1. 导航到要在其中创建项目的空间。

  2. 在空间控制面板上,选择创建项目

  3. 选择从头开始

  4. 为项目命名下,输入要分配给项目的名称。该名称在空间内必须是唯一的。

  5. 选择创建项目

现在您有了一个空项目,下一步是创建源存储库。

创建源存储库

创建源存储库,用于存储和协作处理项目代码。项目成员可以将此存储库克隆到其本地计算机上以处理代码。或者,您可以选择关联在受支持服务中托管的存储库,但本教程未对此进行介绍。有关更多信息,请参阅链接源存储库

创建源存储库
  1. 通过访问 https://codecatalyst.aws/ 打开 CodeCatalyst 控制台。

  2. 导航到您的项目。

  3. 在导航窗格中,选择代码,然后选择源存储库

  4. 选择添加存储库,然后选择创建存储库

  5. 存储库名称中,输入存储库的名称。在本指南中,我们使用 codecatalyst-source-repository,不过您可以选择不同的名称。一个项目中的存储库名称必须唯一。有关存储库名称要求的更多信息,请参阅中的源存储库配额 CodeCatalyst

  6. (可选)在描述中,添加对存储库的描述,这有助于项目中的其他用户了解存储库的用途。

  7. 选择创建存储库(默认)。此选项会创建一个存储库,其中包含默认分支和 README.md 文件。与空存储库不同,您可以在创建此存储库后立即使用它。

  8. 默认分支中,除非您有理由选择其他名称,否则请将该名称保留为 main。本指南中的示例对于默认分支均使用名称 main

  9. (可选)为您计划推送的代码类型添加一个 .gitignore 文件。

  10. 选择创建

    注意

    创建存储库时,CodeCatalyst 会将一个 README.md 文件添加到存储库中。CodeCatalyst还在名为 main 的默认分支中为存储库创建一个初始提交。您可以编辑或删除 README.md 文件,但无法删除默认分支。

您可以通过创建开发环境在存储库中快速添加代码。在本教程中,我们建议您使用 AWS Cloud9 创建开发环境,并在创建开发环境时选择从 main 分支创建分支的选项。我们为此分支使用名称 test,但如果您愿意,可以输入不同的分支名称。

使用新分支创建开发环境
  1. 通过访问 https://codecatalyst.aws/ 打开 CodeCatalyst 控制台。

  2. 导航到要在其中创建开发环境的项目。

  3. 从项目的源存储库列表中选择存储库的名称。另外,在导航窗格中,依次选择代码源存储库以及要为其创建开发环境的存储库。

  4. 在存储库主页上,选择创建开发环境

  5. 从下拉菜单中选择受支持的 IDE。请参阅开发环境支持的集成式开发环境了解更多信息。

  6. 选择要克隆的存储库,选择在新分支中工作,在分支名称字段中输入分支名称,然后从创建分支自下拉菜单中选择要从中创建新分支的分支。

  7. 可选操作,为开发环境添加别名。

  8. 可选操作,选择开发环境配置编辑按钮,编辑开发环境的计算、存储或超时配置。

  9. 选择创建。在创建开发环境时,开发环境状态列将显示正在启动,开发环境创建完成后,状态列将显示正在运行。将在您选择的 IDE 中打开一个新选项卡,其中包含您的开发环境。您可以编辑代码并提交和推送更改。

创建用于构建、测试和部署代码更改的工作流

在 CodeCatalyst 中,您可以在工作流中组织应用程序或服务的构建、测试和部署。工作流由若干操作组成,可以配置为在发生指定的源存储库事件(例如代码推送,或者打开或更新拉取请求)后自动运行。有关工作流的更多信息,请参阅使用工作流进行构建、测试和部署

按照入门工作流中的说明创建您的第一个工作流。

邀请他人加入您的项目

现在您已设置了自定义项目,请邀请其他人与您合作。

邀请他人加入您的项目
  1. 导航到要邀请用户的项目。

  2. 在导航窗格中,选择项目设置

  3. 成员选项卡上,选择邀请

  4. 键入要邀请的用户的电子邮件地址,该用户将作为您项目的用户。您可以键入多个电子邮件地址,用空格或逗号分隔。您也可以从空间成员而不是项目成员中进行选择。

  5. 选择此用户的角色。

    添加完用户后,选择邀请

创建要协作处理并跟踪工作的事务

CodeCatalyst 可以协助您使用事务跟踪项目中涉及的功能、任务、错误以及其他任何工作。您可以创建事务来跟踪所需的工作和想法。默认情况下,创建事务时,事务会添加到待办事项中。您可以将事务移动到面板,在其中跟踪正在进行的工作。您也可以将事务分配给特定的项目成员。

为项目创建事务
  1. 通过访问 https://codecatalyst.aws/ 打开 CodeCatalyst 控制台。

    请确保您正在将要创建事务的项目中导航。要查看所有项目,请在导航窗格中选择 Amazon CodeCatalyst,如果需要,请选择查看所有项目。选择要在其中创建或处理事务的项目。

  2. 在导航窗格中,选择跟踪,然后选择待办事项

  3. 选择创建事务

  4. 事务标题中,提供事务的名称。可选择提供事务的描述。如果需要,可以选择事务的状态、优先级和估计值。您也可以将事务分配给项目成员列表中的项目成员。

    提示

    您可以选择将事务分配给 Amazon Q,让 Amazon Q 尝试解决该事务。如果尝试成功,系统将创建拉取请求,事务状态将更改为审核中,以便您可以查看和测试代码。有关更多信息,请参阅教程:使用 CodeCatalyst 生成式人工智能功能来加快开发工作

    此功能要求为空间启用生成式人工智能功能。有关更多信息,请参阅 Managing generative AI features

  5. 选择保存

创建事务后,您可以将其分配给项目成员,对其进行估算,然后在看板面板上对其进行跟踪。有关更多信息,请参阅跟踪和组织处理问题的工作 CodeCatalyst