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

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

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

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

先决条件

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

创建一个空项目

创建项目是能够协同工作的第一步。如果您想创建自己的资源,例如源存储库和工作流程,则可以从一个空项目开始。

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

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

  3. 选择从头开始

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

  5. 选择创建项目

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

创建源存储库

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

创建源存储库
  1. 打开 CodeCatalyst 控制台,网址为 https://codecatalyst.aws/

  2. 导航到您的项目。

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

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

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

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

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

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

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

  10. 选择创建

    注意

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

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

使用新分支创建开发环境
  1. 打开 CodeCatalyst 控制台,网址为 https://codecatalyst.aws/

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

  3. 从项目的源存储库列表中选择存储库的名称。或者,在导航窗格中,选择代码,选择源存储库,然后选择要为其创建开发环境的存储库。

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

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

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

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

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

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

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

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

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

邀请他人加入你的项目

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

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

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

  3. 在 “成员” 选项卡上,选择 “邀请”。

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

  5. 为用户选择角色。

    添加完用户后,选择邀请

创建要协作处理的议题并跟踪工作

CodeCatalyst 帮助您跟踪项目中涉及的功能、任务、错误以及任何其他有问题的工作。您可以创建议题来跟踪所需的工作和想法。默认情况下,当您创建议题时,它会添加到待办事项中。您可以将问题移至图板,在那里您可以跟踪正在进行的工作。您也可以将议题分配给特定的项目成员。

为项目创建议题
  1. 打开 CodeCatalyst 控制台,网址为 https://codecatalyst.aws/

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

  2. 在导航窗格中,选择 “跟踪”,然后选择 “待办事项列表”。

  3. 选择 “创建问题”。

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

    提示

    您可以选择将问题分配给 Amazon Q,让 Amazon Q 尝试解决问题。如果尝试成功,则将创建拉取请求,问题状态将更改为 “正在审核”,以便您可以查看和测试代码。有关更多信息,请参阅 教程:使用 CodeCatalyst 生成式 AI 功能加快开发工作

    此功能要求为该空间启用生成式 AI 功能。有关更多信息,请参阅管理生成式 AI 功能

  5. 选择保存

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