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

通过在创建项目时选择空项目蓝图，可以创建一个内部没有任何预定义资源的空项目。创建空项目后，您可以根据项目需求创建和添加资源。由于在没有蓝图的情况下创建的项目在创建时为空，因此此选项需要更多有关创建和配置 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，您可以在工作流程中组织应用程序或服务的构建、测试和部署。工作流程由操作组成，可以配置为在发生指定的源存储库事件（例如代码推送或打开或更新拉取请求）后自动运行。有关工作流的更多信息，请参阅使用中的工作流程构建、测试和部署 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。