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

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

# 创建项目
<a name="projects-create"></a>

通过 CodeCatalyst 项目，您可以使用共享持续 integration/continuous 交付 (CI/CD) 工作流程和存储库执行开发任务、管理资源、跟踪问题和添加用户。

在创建项目之前，您必须具有**空间管理员**或**高级用户**角色。

**Topics**
+ [

## 在 Amazon 中创建一个空项目 CodeCatalyst
](#projects-create-empty)
+ [

## 使用链接的第三方存储库创建项目
](#projects-create-3p-repo)
+ [

## 使用蓝图创建项目
](#projects-create-console-template)
+ [

## 使用 Amazon Q 通过蓝图创建项目或添加功能时的最佳实践
](#projects-create-amazon-q)
+ [

## 将蓝图与项目结合使用的最佳实践
](#projects-create-use-blueprints)
+ [

## 向已创建的项目添加资源和任务
](#projects-create-after-steps)

## 在 Amazon 中创建一个空项目 CodeCatalyst
<a name="projects-create-empty"></a>

您可以创建没有资源的空项目，并在稍后手动添加所需的资源。

在创建项目之前，您必须具有**空间管理员**或**高级用户**角色。

**创建空项目**

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

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

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

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

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

## 使用链接的第三方存储库创建项目
<a name="projects-create-3p-repo"></a>

您可以将项目的源代码保存在首选的第三方提供商中，但仍可使用蓝图、生命周期管理、工作流程等所有 CodeCatalyst 功能。为此，您可以创建一个链接到 GitHub 存储库、Bitbucket 存储库或 CodeCatalyst 项目存储库的新 GitLab 项目。然后，您可以在 CodeCatalyst 项目中使用您的链接源代码库。

在创建 CodeCatalyst 项目之前，您必须拥有 **Space 管理员**或 **Power 用户**角色。有关更多信息，请参阅[创建空间](spaces-create.md)和[直接邀请用户进入空间](spaces-members-add-admin.md)。

要在链接到您 GitHub 账户中的 CodeCatalyst 源存储库的项目中创建项目，您需要完成以下三个任务：

1. 安装**GitHub 存储库**、**Bitbucket 存储库**或**GitLab 存储库**扩展。在外部站点中，系统会提示您连接并 CodeCatalyst 提供对存储库的访问权限，这将在下一步中完成。
**重要**  
要将**GitHub 存储库**、**Bitbuck** et **GitLab 存储库或存储库**扩展安装到您的 CodeCatalyst 空间，您必须使用在该空间中具有**空间管理员**角色的账户登录。

1. 将您的 GitHub 账户、Bitbucket 工作空间或 GitLab 用户连接到。 CodeCatalyst
**重要**  
要将您的 GitHub 账户、Bitbucket 工作 CodeCatalyst 空间、 GitLab 用户连接到您的空间，您必须同时是第三方来源的管理员和 CodeCatalyst **空间管理员**。
**重要**  
安装存储库扩展后，您链接到的任何存储库都 CodeCatalyst 将对其代码进行索引和存储。 CodeCatalyst这将使代码可在中 CodeCatalyst搜索。要更好地了解在中使用链接存储库时代码的数据保护 CodeCatalyst，请参阅 *Amazon CodeCatalyst 用户指南*中的[数据保护](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html)。

1. 创建 CodeCatalyst 链接到您的 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库的项目。
**重要**  
虽然您可以作为**贡献者**链接 GitHub 存储库、Bitbucket 存储库或 GitLab 项目仓库，但您只能以 **Space 管理员或**项目**管理员**的身份取消第三方仓库的链接。有关更多信息，请参阅 [取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-unlink.md)。
**重要**  
CodeCatalyst 不支持检测链接仓库的默认分支中的更改。要更改链接存储库的默认分支，必须先取消其与该分支的链接 CodeCatalyst，更改默认分支，然后再次进行链接。有关更多信息，请参阅 [在中关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-link.md)。  
作为最佳实践，在链接存储库之前，请始终确保您拥有最新版本的扩展。
**注意**  
 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库只能链接到空间中的一个 CodeCatalyst 项目。
您不能将空仓库或已存档 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库与 CodeCatalyst 项目一起使用。
您不能链接与 GitLab 项目中 GitHub 仓库同名的存储库、Bitbucket 存储库或 CodeCatalyst 项目存储库。
**GitHub 存储库**扩展与 GitHub 企业服务器存储库不兼容。
**Bitbucket 存储库**扩展与 Bitbucket Data Center 存储库不兼容。
**GitLab 存储库**扩展与 GitLab 自行管理的项目存储库不兼容。
您无法在已链接存储库中使用**为我编写描述**或**汇总评论**功能。这些功能仅在中的拉取请求中可用 CodeCatalyst。

有关更多信息，请参阅 [为带有扩展程序的项目添加功能 CodeCatalyst使用扩展向项目添加功能](extensions.md)。

**安装第三方扩展**

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

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

1. 选择**自带代码**。

1. **在 “**链接现有存储库**” 下，根据要使用的第三方**存储库提供商选择GitHub **GitLab 存储库**、Bitbu** cket 存储库和存储库。**如果您之前没有关联您的 GitHub 账户、Bitbucket 工作空间或 GitLab 账户，则系统会提示您进行关联。如果您选择的第三方扩展尚未安装，系统会显示安装提示。

1. 如果出现提示，请选择**安装**。查看扩展所需的权限，如果要继续，请再次选择**安装**。

安装第三方扩展程序后，下一步是将您的 GitHub 账户、Bitbucket 工作空间或 GitLab 用户连接到您的 CodeCatalyst 空间。

**将您的 GitHub 账户、Bitbucket 工作空间或 GitLab 用户连接到 CodeCatalyst**

根据您选择配置的第三方扩展执行下列操作之一：
+ **GitHub 存储库**：Connect 连接到 GitHub 帐户。

  1. 选择 **Connect GitHub 帐户**以访问外部站点 GitHub。

  1. 使用您的 GitHub 凭证登录您的 GitHub 账户，然后选择要安装Amazon的账户 CodeCatalyst。
**提示**  
如果您之前已将 GitHub 账户关联到该空间，则系统不会提示您重新授权。相反，如果您是多个空间的成员或合作者，则会看到一个对话框，询问您要在哪里安装扩展程序；如果您只属于一个 GitHub 空间，则会看到Amazon CodeCatalyst 应用程序的配置页面。 GitHub 为要允许的存储库访问权限配置应用程序，然后选择**保存**。如果**保存**按钮未激活，请更改配置，然后重试。

  1. 选择是 CodeCatalyst 允许访问所有当前和将来的存储库，还是选择要在中使用的特定 GitHub 存储库 CodeCatalyst。默认选项是将 GitHub 账户中的所有 GitHub 存储库包括在内，包括将由访问的 future 存储库 CodeCatalyst。

  1. 查看授予的权限 CodeCatalyst，然后选择 “**安装**”。

  将您的 GitHub 账户关联到后 CodeCatalyst，系统会将您带到**GitHub 存储库**扩展详情页面，您可以在其中查看和管理关联的 GitHub 账户和关联的 GitHub 存储库。
+ **Bitbucket 存储库**：连接到 Bitbucket 工作区。

  1. 选择**连接 Bitbucket 工作区**以转到 Bitbucket 的外部站点。

  1. 使用您的 Bitbucket 凭据登录您的 Bitbucket 工作空间并查看授予的权限。 CodeCatalyst

  1. 从 “**授权工作空间**” 下拉菜单中，选择要提供 CodeCatalyst 访问权限的 Bitbucket 工作空间，然后选择 “**授予访问权限**”。
**提示**  
如果您之前已将 Bitbucket 工作区连接到空间，则系统不会提示您重新授权。相反，如果您是多个 Bitbucket 工作空间的成员或合作者，则会看到一个对话框，询问您要在哪里安装扩展程序；如果您只属于一个 Bitbucket 工作空间，则会看到亚马逊 CodeCatalyst 应用程序的配置页面。为要允许的工作区访问权限配置应用程序，然后选择**授予访问权限**。如果**授予访问权限**按钮未激活，请更改配置，然后重试。

  将 Bitbucket 工作空间连接到后 CodeCatalyst，您将被带到 **Bitbucket 存储库**扩展详细信息页面，您可以在其中查看和管理已连接的 Bitbucket 工作空间和关联的 Bitbucket 存储库。
+ **GitLab 存储库**：Connect 连接到 GitLab 用户。

  1. 选择 **Connect GitLab 用户**以访问外部站点 GitLab。

  1. 使用您的 GitLab 证书登录您的 GitLab 用户并查看授予的权限 CodeCatalyst。
**提示**  
如果您之前已将 GitLab 用户连接到空间，则系统不会提示您重新授权。相反，您将被导航回 CodeCatalyst 控制台。

  1. 选择 “**为 AWS 连接器授权” GitLab**。

  将 GitLab 用户连接到后 CodeCatalyst，系统会将您带到**GitLab 存储库**扩展详细信息页面，您可以在其中查看和管理关联的 GitLab 用户和关联的 GitLab 项目存储库。

将第三方来源连接到后 CodeCatalyst，您可以将第三方存储库链接到您的 CodeCatalyst 项目。

**创建您的项目**

1. 在**创建项目**页面上，选择您关联的 GitHub 账户。

1. **根据您连接的第三方存储库提供商，选择**GitHub 存储库**、**Bitbuck** et 存储库或GitLab 存储库存储库下拉菜单以查看第三方存储库，然后选择要链接到项目的存储库。**

1. 在**命名项目**文本输入字段中，输入要分配给项目的名称。该名称在空间内必须是唯一的。

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

安装**GitHub 存储库**、**Bitbuck** et **GitLab 存储库或存储库**扩展、连接资源提供商并将第三方存储库与 CodeCatalyst 项目关联后，您可以在 CodeCatalyst 工作流程和开发环境中使用它。您还可以在关联的 GitHub 账户、Bitbucket 工作区或 GitLab 使用蓝图生成的代码的用户中创建第三方存储库。您还可以将已链接存储库与 Amazon Q 开发者版、蓝图等结合使用。有关更多信息，请参阅[在第三方存储库事件发生后自动启动工作流运行](extensions-workflow-repositories.md)和[创建开发环境](devenvironment-create.md)。

## 使用蓝图创建项目
<a name="projects-create-console-template"></a>

您可以使用项目蓝图预置所有项目资源和示例代码。有关蓝图的信息，请参阅[使用 CodeCatalyst 蓝图创建综合项目使用蓝图创建综合项目](project-blueprints.md)。

**使用蓝图创建项目**

1. 在 CodeCatalyst 控制台中，导航到要在其中创建项目的空间。

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

1. 选择**从蓝图开始**。
**提示**  
您可以选择向 **Amazon Q** 提供您的项目需求，让 Amazon Q 为您推荐蓝图，以此来添加蓝图。有关更多信息，请参阅[创建项目或添加功能时使用 Amazon Q 选择蓝图](getting-started-project-assistance.md#getting-started-project-assistance-create-apply-bp)和[使用 Amazon Q 通过蓝图创建项目或添加功能时的最佳实践](#projects-create-amazon-q)。此功能仅在美国西部（俄勒冈州）区域中提供。  
此功能要求为空间启用生成式人工智能功能。有关更多信息，请参阅 [Managing generative AI features](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html)。

1. **在**CodeCatalyst 蓝图**或**空间蓝**图选项卡中，选择蓝图，然后选择下一步。**

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

1. （可选）默认情况下，蓝图创建的源代码存储在存储 CodeCatalyst 库中。此外，您可以选择将蓝图源代码存储在第三方存储库中。有关更多信息，请参阅 [为带有扩展程序的项目添加功能 CodeCatalyst使用扩展向项目添加功能](extensions.md)。
**重要**  
CodeCatalyst 不支持检测链接仓库的默认分支中的更改。要更改链接存储库的默认分支，必须先取消其与该分支的链接 CodeCatalyst，更改默认分支，然后再次进行链接。有关更多信息，请参阅 [在中关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-link.md)。  
作为最佳实践，在链接存储库之前，请始终确保您拥有最新版本的扩展。

   根据要使用的第三方存储库提供商，执行以下操作之一：
   + **GitHub 存储库**：Connect GitHub 账户。

     选择 “**高级**” 下拉菜单，选择 GitHub作为存储库提供者，然后选择要存储蓝图创建的源代码的 GitHub 帐户。
**注意**  
如果您要关联 GitHub 账户，则必须创建个人连接才能在您的身份和身份之间建立 CodeCatalyst 身份映射。 GitHub 有关更多信息，请参阅[个人连接](concepts.md#personal-connection-concept)和[通过人际关系访问 GitHub 资源](ipa-settings-connections.md)。
   + **Bitbucket 存储库**：连接 Bitbucket 工作区。

     选择**高级**下拉菜单，选择 Bitbucket 作为存储库提供商，然后选择用于存储蓝图所创建的源代码的 Bitbucket 工作区。
   + **GitLab 存储库**：Connect GitLab 用户。

     选择 “**高级**” 下拉菜单，选择 GitLab作为存储库提供者，然后选择要存储蓝图创建的源代码的 GitLab 用户。

1. 在**项目资源**下，配置蓝图参数。根据蓝图的不同，您可以选择命名源存储库名称。

1. （可选）要根据您选择的项目参数查看包含更新的定义文件，请从**生成项目预览**中选择**查看代码**或**查看工作流**。

1. （可选）从蓝图卡中选择**查看详细信息**，查看蓝图的具体详细信息，如蓝图架构概述、所需连接和权限，以及蓝图创建的资源种类。

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

## 使用 Amazon Q 通过蓝图创建项目或添加功能时的最佳实践
<a name="projects-create-amazon-q"></a>

当您创建项目或想要向现有项目添加新组件时，您可能不确定要使用哪个蓝图或如何集成功能。 CodeCatalyst 包括与名为 Amazon Q 的生成式 AI 助手的集成，该助手可以分析您的项目需求并提出最适合您需求的蓝图。

您可以使用 Amazon Q 来帮助您创建带蓝图的项目，该蓝图可以根据您的要求创建组件，或者您可以使用 Amazon Q 来帮助您将蓝图添加到现有项目中。例如，要将适用于 Web 应用程序或现代应用程序的资源添加到项目，请指定您的要求，之后这些资源将与建议的蓝图一起添加。可以为您创建其余组件的事务。

Amazon Q 还会针对建议的蓝图无法满足的要求创建事务。此外，您可以将这些事务分配给 Amazon Q。如果您将事务分配给 Amazon Q，它将尝试创建解决方案草稿以供您评估。这有助于您和您的团队专注于并优化处理需要关注的事务，而 Amazon Q 则专注于解决您没有资源来立即解决的问题。

**注意**  
**由 Amazon Bedrock** 提供支持： AWS 实现[自动滥用检测](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html)。由于**为我编写描述**、**创建内容摘要**、**推荐任务**、**使用 Amazon Q 创建功能或将功添加到项目**以及**将事务分配给 Amazon Q** 功能与用于软件开发的 Amazon Q 开发者版代理程序的功能都是基于 Amazon Bedrock 构建的，因此，用户可以充分利用 Amazon Bedrock 中实施的控制措施来强制实施安全性并负责任地使用人工智能（AI）。

以下是一些最佳实践，可帮助您使用 Amazon Q 创建项目和添加蓝图。

**重要**  
生成式人工智能功能仅在美国西部（俄勒冈州）区域中可用。
+ **使用 Amazon Q 提供的默认提示**。Amazon Q 非常适合根据提供的提示选择蓝图。
+ **使用 Amazon Q 建议的配置选项来预览蓝图**。选择一个蓝图以预览该蓝图将创建的示例代码和资源。
+ **使用为 Amazon Q 启用的空间**。要使用 Amazon Q 创建项目，或使用 Amazon Q 向带蓝图的项目添加功能，请使用为生成式人工智能功能启用的空间。有关更多信息，请参阅 [Enabling or disabling generative AI features for a space](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html#managing-generative-ai-features-enable-disable)。
+ **获取有关 Amazon Q 建议的蓝图的更多信息**。您可能需要详细了解使用建议的特定蓝图创建的项目资源、示例代码和组件的类型。有关中可用蓝图的更多信息 CodeCatalyst，请参阅[使用 CodeCatalyst 蓝图创建综合项目使用蓝图创建综合项目](project-blueprints.md)。
+ **允许 Amazon Q 处理事务**。允许 Amazon Q 为您创建事务、分配这些事务并对其进行跟踪。有关更多信息，请参阅 [教程：使用 CodeCatalyst 生成式 AI 功能加快开发工作](getting-started-project-assistance.md)。
+ **取消向 Amazon Q 分配不再处理的事务**。完成示例后，取消向 Amazon Q 分配不再处理的任何事务。如果 Amazon Q 已完成对某个事务的处理或找不到解决方案，请务必取消分配 Amazon Q，以免达到生成式人工智能功能的最大配额。有关更多信息，请参阅 [Managing generative AI features](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html) 和 [Pricing](https://codecatalyst.aws/explore/pricing)。
+ **查看 Amazon Q 的使用情况**。您可以在用户级别查看生成式人工智能功能的使用情况。转到**我的设置**以管理生成式人工智能配额，并按您的构建者 ID 或单点登录（SSO）身份查看使用情况。有关更多信息，请参阅 [Viewing usage of generative AI features in a space](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html#managing-generative-ai-features-view-usage)。

**重要**  
中的生成式 AI 功能 CodeCatalyst 受配额限制。有关更多信息，请参阅 [Amazon Q 开发者版定价](https://aws.amazon.com/q/developer/pricing/)、[Enabling or disabling generative AI features for a space](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html#managing-generative-ai-features-enable-disable) 和 [ Billing](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html)。

## 将蓝图与项目结合使用的最佳实践
<a name="projects-create-use-blueprints"></a>

以下是一些最佳实践，可帮助您使用蓝图创建项目或添加蓝图。
+ **使用提供的 CodeCatalyst 蓝图创建项目或将其添加到项目**中。您可以使用蓝图为开发人员创建包含源代码和资源的完整项目。例如，Web 应用程序蓝图创建应用程序和基础设施资源并部署 Web 应用程序。您可以使用蓝图创建项目，或将自定义蓝图添加到现有项目中。有关更多信息，请参阅 [使用蓝图创建项目](create-project-with-bp.md)。在中 CodeCatalyst 查看任何蓝图，预览蓝图将创建的示例代码和资源。
+ **使用您的组织设计的自定义蓝图**。您可以使用自定义蓝图在空间中创建完整项目。您的组织设计的自定义蓝图可以提供标准化和最佳实践，这也有助于减少设置新项目所需的工作量。作为自定义蓝图作者，您可以详细了解哪些项目正在空间中使用您的蓝图。利用生命周期管理功能，您可以集中管理每个项目的软件开发生命周期，并且蓝图用户可以利用生命周期管理功能从蓝图的更新选项或版本中重新生成代码库。有关更多信息，请参阅 [以蓝图作者的身份使用生命周期管理功能](lifecycle-management-dev.md)。
+ **将开发人员角色或相应的 IAM 角色添加到您项目的账户**。在完成项目创建步骤期间或之后，您可以通过在已连接到空间的 AWS 账户 中选择或创建 IAM 角色来配置蓝图权限。

## 向已创建的项目添加资源和任务
<a name="projects-create-after-steps"></a>

在项目准备就绪后，您可以添加资源和任务。
+ 要了解使用您的项目创建 CI/CD 的工作流程，请参阅[入门工作流](workflows-getting-started.md)。
+ 要使用与新项目中的构建操作（这些操作将构建构件部署到 Amazon S3 存储桶），请参阅[使用工作流进行构建](build-workflow-actions.md)和[教程：将构件上传到 Amazon S3](build-deploy.md)。
+ 要从一个空项目开始，然后使用 CloudFormation 堆栈部署来部署类似的无服务器应用程序，请参阅[教程：部署无服务器应用程序](deploy-tut-lambda.md)。
+ 要添加事务规划面板，请参阅[跟踪和组织处理问题的工作 CodeCatalyst跟踪和整理有关事务的工作](issues.md)。
+ 要查看项目概述、项目状态、最近的团队活动和分配的工作，请参阅[获取项目列表](projects-view.md)。
+ 要查看源代码或创建拉取请求，请参阅[使用源存储库存储代码并协作处理代码 CodeCatalyst使用源存储库存储代码并进行协作](source.md)。
+ 要设置发送工作流运行成功或失败的状态提醒的通知，请参阅[从 CodeCatalyst 发送 Slack 和电子邮件通知](notifications-manage.md)。
+ 要邀请成员加入您的项目，请参阅[向用户授予项目权限](projects-members.md)。
+ 要设置开发环境，请参阅[使用开发环境编写和修改代码 CodeCatalyst使用开发环境编写和修改代码](devenvironment.md)。