本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
教程:从一个空项目开始,然后手动添加资源
通过在创建项目时选择空项目蓝图,可以创建一个内部不含任何预定义资源的空项目。创建空项目后,您可以根据项目需求创建和添加资源。由于在不使用蓝图的情况下创建的项目在创建时为空,因而需要有更多有关创建和配置 CodeCatalyst 资源的知识,才能开始使用此选项。
先决条件
要创建空项目,必须为您分配空间管理员或高级用户角色。如果这是您首次登录 CodeCatalyst,请参阅设置并登录 CodeCatalyst。
创建空项目
要协同工作,首先要创建项目。如果您想创建自己的资源(例如源存储库和工作流),则可以从一个空项目开始。
创建空项目
-
导航到要在其中创建项目的空间。
-
在空间控制面板上,选择创建项目。
-
选择从头开始。
-
在为项目命名下,输入要分配给项目的名称。该名称在空间内必须是唯一的。
-
选择创建项目。
现在您有了一个空项目,下一步是创建源存储库。
创建源存储库
创建源存储库,用于存储和协作处理项目代码。项目成员可以将此存储库克隆到其本地计算机上以处理代码。或者,您可以选择关联在受支持服务中托管的存储库,但本教程未对此进行介绍。有关更多信息,请参阅链接源存储库。
创建源存储库
通过访问 https://codecatalyst.aws/
打开 CodeCatalyst 控制台。 -
导航到您的项目。
-
在导航窗格中,选择代码,然后选择源存储库。
-
选择添加存储库,然后选择创建存储库。
-
在存储库名称中,输入存储库的名称。在本指南中,我们使用
codecatalyst-source-repository
,不过您可以选择不同的名称。一个项目中的存储库名称必须唯一。有关存储库名称要求的更多信息,请参阅中的源存储库配额 CodeCatalyst。 -
(可选)在描述中,添加对存储库的描述,这有助于项目中的其他用户了解存储库的用途。
-
选择创建存储库(默认)。此选项会创建一个存储库,其中包含默认分支和 README.md 文件。与空存储库不同,您可以在创建此存储库后立即使用它。
-
在默认分支中,除非您有理由选择其他名称,否则请将该名称保留为 main。本指南中的示例对于默认分支均使用名称 main。
-
(可选)为您计划推送的代码类型添加一个
.gitignore
文件。 -
选择创建。
注意
创建存储库时,CodeCatalyst 会将一个
README.md
文件添加到存储库中。CodeCatalyst还在名为 main 的默认分支中为存储库创建一个初始提交。您可以编辑或删除 README.md 文件,但无法删除默认分支。
您可以通过创建开发环境在存储库中快速添加代码。在本教程中,我们建议您使用 AWS Cloud9 创建开发环境,并在创建开发环境时选择从 main 分支创建分支的选项。我们为此分支使用名称 test
,但如果您愿意,可以输入不同的分支名称。
使用新分支创建开发环境
通过访问 https://codecatalyst.aws/
打开 CodeCatalyst 控制台。 导航到要在其中创建开发环境的项目。
从项目的源存储库列表中选择存储库的名称。另外,在导航窗格中,依次选择代码、源存储库以及要为其创建开发环境的存储库。
在存储库主页上,选择创建开发环境。
从下拉菜单中选择受支持的 IDE。请参阅开发环境支持的集成式开发环境了解更多信息。
选择要克隆的存储库,选择在新分支中工作,在分支名称字段中输入分支名称,然后从创建分支自下拉菜单中选择要从中创建新分支的分支。
可选操作,为开发环境添加别名。
可选操作,选择开发环境配置编辑按钮,编辑开发环境的计算、存储或超时配置。
选择创建。在创建开发环境时,开发环境状态列将显示正在启动,开发环境创建完成后,状态列将显示正在运行。将在您选择的 IDE 中打开一个新选项卡,其中包含您的开发环境。您可以编辑代码并提交和推送更改。
创建用于构建、测试和部署代码更改的工作流
在 CodeCatalyst 中,您可以在工作流中组织应用程序或服务的构建、测试和部署。工作流由若干操作组成,可以配置为在发生指定的源存储库事件(例如代码推送,或者打开或更新拉取请求)后自动运行。有关工作流的更多信息,请参阅使用工作流进行构建、测试和部署。
按照入门工作流中的说明创建您的第一个工作流。
邀请他人加入您的项目
现在您已设置了自定义项目,请邀请其他人与您合作。
邀请他人加入您的项目
-
导航到要邀请用户的项目。
-
在导航窗格中,选择项目设置。
-
在成员选项卡上,选择邀请。
-
键入要邀请的用户的电子邮件地址,该用户将作为您项目的用户。您可以键入多个电子邮件地址,用空格或逗号分隔。您也可以从空间成员而不是项目成员中进行选择。
选择此用户的角色。
添加完用户后,选择邀请。
创建要协作处理并跟踪工作的事务
CodeCatalyst 可以协助您使用事务跟踪项目中涉及的功能、任务、错误以及其他任何工作。您可以创建事务来跟踪所需的工作和想法。默认情况下,创建事务时,事务会添加到待办事项中。您可以将事务移动到面板,在其中跟踪正在进行的工作。您也可以将事务分配给特定的项目成员。
为项目创建事务
-
通过访问 https://codecatalyst.aws/
打开 CodeCatalyst 控制台。 请确保您正在将要创建事务的项目中导航。要查看所有项目,请在导航窗格中选择 Amazon CodeCatalyst,如果需要,请选择查看所有项目。选择要在其中创建或处理事务的项目。
-
在导航窗格中,选择跟踪,然后选择待办事项。
-
选择创建事务。
-
在事务标题中,提供事务的名称。可选择提供事务的描述。如果需要,可以选择事务的状态、优先级和估计值。您也可以将事务分配给项目成员列表中的项目成员。
提示
您可以选择将事务分配给 Amazon Q,让 Amazon Q 尝试解决该事务。如果尝试成功,系统将创建拉取请求,事务状态将更改为审核中,以便您可以查看和测试代码。有关更多信息,请参阅教程:使用 CodeCatalyst 生成式人工智能功能来加快开发工作。
此功能要求为空间启用生成式人工智能功能。有关更多信息,请参阅 Managing generative AI features。
-
选择保存。
创建事务后,您可以将其分配给项目成员,对其进行估算,然后在看板面板上对其进行跟踪。有关更多信息,请参阅跟踪和组织处理问题的工作 CodeCatalyst。