亚马逊 CodeCatalyst 不再向新买家开放。现有客户可以继续正常使用该服务。有关更多信息，请参阅 [如何从中迁移 CodeCatalyst](migration.md)。

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

# 教程：从一个空项目开始，然后手动添加资源
<a name="getting-started-blank-template"></a>

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

**Topics**
+ [先决条件](#getting-started-bt-prerequisites)
+ [创建空项目](#getting-started-bt-proj-create)
+ [创建源存储库](#getting-started-bt-source-create)
+ [创建用于构建、测试和部署代码更改的工作流](#getting-started-bt-workflow-create)
+ [邀请他人加入您的项目](#getting-started-bt-ipa-user)
+ [创建要协作处理并跟踪工作的事务](#getting-started-bt-issue)

## 先决条件
<a name="getting-started-bt-prerequisites"></a>

要创建空项目，必须为您分配**空间管理员**或**高级用户**角色。如果这是您第一次登录 CodeCatalyst，请参阅[设置并登录 CodeCatalyst设置并登录 CodeCatalyst](setting-up-topnode.md)。

## 创建空项目
<a name="getting-started-bt-proj-create"></a>

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

**创建空项目**

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

1. 在空间控制面板上，选择**创建项目**。

1. 选择**从头开始**。

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

1. 选择**创建项目**。

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

## 创建源存储库
<a name="getting-started-bt-source-create"></a>

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

**创建源存储库**

1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 导航到您的项目。

1. 在导航窗格中，选择**代码**，然后选择**源存储库**。

1. 选择**添加存储库**，然后选择**创建存储库**。

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

1. （可选）在**描述**中，添加对存储库的描述，这有助于项目中的其他用户了解存储库的用途。

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

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

1. （可选）为您计划推送的代码类型添加一个 `.gitignore` 文件。

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

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

**使用新分支创建开发环境**

1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。

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

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

1. 在存储库主页上，选择**创建开发环境**。

1. 从下拉菜单中选择受支持的 IDE。请参阅[开发环境支持的集成式开发环境](devenvironment-create.md#devenvironment-supported-ide)了解更多信息。

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

1. 可选操作，为开发环境添加别名。

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

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

## 创建用于构建、测试和部署代码更改的工作流
<a name="getting-started-bt-workflow-create"></a>

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

按照[入门工作流](workflows-getting-started.md)中的说明创建您的第一个工作流。

## 邀请他人加入您的项目
<a name="getting-started-bt-ipa-user"></a>

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

**邀请他人加入您的项目**

1. 导航到要邀请用户的项目。

1. 在导航窗格中，选择**项目设置**。

1. 在**成员**选项卡上，选择**邀请**。

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

1. 选择此用户的角色。

   添加完用户后，选择**邀请**。

## 创建要协作处理并跟踪工作的事务
<a name="getting-started-bt-issue"></a>

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

**为项目创建事务**

1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。

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

1. 在导航窗格中，选择**跟踪**，然后选择**待办事项**。

1. 选择**创建事务**。

1. 在**事务标题**中，提供事务的名称。可选择提供事务的描述。如果需要，可以选择事务的状态、优先级和估计值。您也可以将事务分配给项目成员列表中的项目成员。
**提示**  
您可以选择将事务分配给 **Amazon Q**，让 Amazon Q 尝试解决该事务。如果尝试成功，系统将创建拉取请求，事务状态将更改为**审核中**，以便您可以查看和测试代码。有关更多信息，请参阅 [教程：使用 CodeCatalyst 生成式 AI 功能加快开发工作](getting-started-project-assistance.md)。  
此功能要求为空间启用生成式人工智能功能。有关更多信息，请参阅 [Managing generative AI features](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html)。

1. 选择**保存**。

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