创建项目 - Amazon CodeCatalyst
创建一个空项目使用链接的第三方存储库创建项目使用蓝图创建项目使用 Amazon Q 创建项目或通过蓝图添加功能的最佳实践在项目中使用蓝图的最佳实践向已创建的项目添加资源和任务

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

创建项目

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

在创建项目之前，您必须拥有 Space 管理员或 Power 用户角色。

在 Amazon 中创建一个空项目 CodeCatalyst

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

在创建项目之前，您必须拥有 Space 管理员或 Power 用户角色。

创建空项目

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

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

  3. 选择从头开始。

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

  5. 选择创建项目。

使用链接的第三方存储库创建项目

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

在创建 CodeCatalyst 项目之前，您必须拥有 Space 管理员或 Power 用户角色。有关更多信息，请参阅创建空间 和直接邀请用户进入空间 。

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

  1. 安装GitHub 存储库、Bitbucket 存储库或GitLab 存储库扩展。在外部站点中，系统会提示您连接并 CodeCatalyst 提供对存储库的访问权限，这将在下一步中完成。

    重要

    要将GitHub 存储库、Bitbuck et GitLab 存储库或存储库扩展安装到您的 CodeCatalyst 空间，您必须使用在该空间中具有空间管理员角色的账户登录。

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

    重要

    要将您的 GitHub 账户、Bitbucket 工作 CodeCatalyst 空间、 GitLab 用户连接到您的空间，您必须同时是第三方来源的管理员和 CodeCatalyst 空间管理员。

    重要

    安装存储库扩展后，您链接到的任何存储库都 CodeCatalyst 将对其代码进行索引和存储。 CodeCatalyst这将使代码可在中 CodeCatalyst搜索。要更好地了解在中使用链接存储库时代码的数据保护 CodeCatalyst，请参阅 Amazon CodeCatalyst 用户指南中的数据保护。

  3. 创建 CodeCatalyst 链接到您的 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库的项目。

    重要

    虽然您可以作为贡献者链接 GitHub 存储库、Bitbucket 存储库或 GitLab 项目仓库，但您只能以 Space 管理员或项目管理员的身份取消第三方仓库的链接。有关更多信息，请参阅 取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst。

    重要

    CodeCatalyst 不支持检测链接仓库的默认分支中的更改。要更改链接存储库的默认分支，必须先取消其与该分支的链接 CodeCatalyst，更改默认分支，然后再次进行链接。有关更多信息，请参阅 在中关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst。

    作为最佳实践，在链接存储库之前，请务必确保您拥有最新版本的扩展程序。

    注意

    • GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库只能链接到空间中的一个 CodeCatalyst 项目。

    • 您不能将空仓库或已存档 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库与 CodeCatalyst 项目一起使用。

    • 您不能链接与 GitLab 项目中 GitHub 仓库同名的存储库、Bitbucket 存储库或 CodeCatalyst 项目存储库。

    • GitHub 存储库扩展与 GitHub 企业服务器存储库不兼容。

    • Bitbucket 存储库扩展与 Bitbucket 数据中心存储库不兼容。

    • GitLab 存储库扩展与 GitLab 自行管理的项目存储库不兼容。

    • 您不能在链接的仓库中使用 “为我写描述” 或 “汇总评论” 功能。这些功能仅在中的拉取请求中可用 CodeCatalyst。

有关更多信息，请参阅 为带有扩展的项目添加功能 CodeCatalyst。

安装第三方扩展

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

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

  3. 选择 “自带代码”。

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

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

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

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

根据您选择配置的第三方扩展，执行以下任一操作：

  • GitHub 存储库：Connect 连接到 GitHub 帐户。

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

    2. 使用您的 GitHub 凭证登录您的 GitHub 账户，然后选择要安装Amazon的账户 CodeCatalyst。

      提示

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

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

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

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

  • Bitbucket 存储库：连接到 Bitbucket 工作空间。

    1. 选择 Connect Bitbucket 工作空间可前往 Bitbucket 的外部站点。

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

    3. 从 “授权工作空间” 下拉菜单中，选择要提供 CodeCatalyst 访问权限的 Bitbucket 工作空间，然后选择 “授予访问权限”。

      提示

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

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

  • GitLab 存储库：Connect 连接到 GitLab 用户。

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

    2. 使用您的 GitLab 证书登录您的 GitLab 用户并查看授予的权限 CodeCatalyst。

      提示

      如果您之前已将 GitLab 用户连接到空间，则系统不会提示您重新授权。相反，您将被导航回 CodeCatalyst 控制台。

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

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

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

创建您的项目

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

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

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

  4. 选择创建项目。

安装GitHub 存储库、Bitbuck et GitLab 存储库或存储库扩展、连接资源提供商并将第三方存储库与 CodeCatalyst 项目关联后，您可以在 CodeCatalyst 工作流程和开发环境中使用它。您还可以在关联的 GitHub 账户、Bitbucket 工作区或 GitLab 使用蓝图生成的代码的用户中创建第三方存储库。您还可以将链接存储库与 Amazon Q Developer、蓝图等配合使用。有关更多信息，请参阅在第三方存储库事件发生后自动启动工作流程 和创建开发环境。

使用蓝图创建项目

您可以使用项目蓝图来配置所有项目资源和示例代码。有关蓝图的信息，请参阅。使用 CodeCatalyst 蓝图创建综合项目

使用蓝图创建项目

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

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

  3. 选择 “从蓝图开始”。

    提示

    您可以选择添加蓝图，方法是向 Amazon Q 提供您的项目要求，让 Amazon Q 向您推荐蓝图。有关更多信息，请参阅创建项目或添加功能时使用 Amazon Q 选择蓝图 和使用 Amazon Q 创建项目或通过蓝图添加功能的最佳实践。此功能仅在美国西部（俄勒冈）区域可用。

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

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

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

  6. （可选）默认情况下，蓝图创建的源代码存储在存储 CodeCatalyst 库中。或者，您可以选择将蓝图的源代码存储在第三方存储库中。有关更多信息，请参阅 为带有扩展的项目添加功能 CodeCatalyst。

    重要

    CodeCatalyst 不支持检测链接仓库的默认分支中的更改。要更改链接存储库的默认分支，必须先取消其与该分支的链接 CodeCatalyst，更改默认分支，然后再次进行链接。有关更多信息，请参阅 在中关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst。

    作为最佳实践，在链接存储库之前，请务必确保您拥有最新版本的扩展程序。

    根据您要使用的第三方存储库提供商，执行以下任一操作：

    • GitHub 存储库：Connect GitHub 账户。

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

      注意

      如果您要关联 GitHub 账户，则必须创建个人连接才能在您的身份和身份之间建立 CodeCatalyst 身份映射。 GitHub 有关更多信息，请参阅人际关系 和通过人际关系访问 GitHub 资源。

    • Bitbucket 存储库：连接 Bitbucket 工作空间。

      选择 “高级” 下拉菜单，选择 Bitbucket 作为存储库提供程序，然后选择要存储蓝图创建的源代码的 Bitbucket 工作空间。

    • GitLab 存储库：Connect GitLab 用户。

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

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

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

  9. （可选）从蓝图的卡片中选择查看详细信息以查看有关蓝图的特定详细信息，例如蓝图架构概述、所需的连接和权限以及蓝图创建的资源类型。

  10. 选择创建项目。

使用 Amazon Q 创建项目或通过蓝图添加功能的最佳实践

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

您可以使用 Amazon Q 来帮助您创建带有蓝图的项目，该蓝图可以根据您的要求创建组件，也可以使用 Amazon Q 来帮助您将蓝图添加到现有项目中。例如，要将 Web 应用程序或现代应用程序的资源添加到项目中，请指定您的要求，然后将资源与推荐的蓝图一起添加。可以为您创建剩余组件的问题。

Amazon Q 还会为建议的蓝图无法解决的需求带来问题。此外，您可以将这些问题分配给 Amazon Q。如果您将问题分配给 Amazon Q，它将尝试创建解决方案草案供您评估。这可以帮助您和您的团队将工作重点放在需要您注意的问题上，并对其进行优化，而 Amazon Q 则为您没有资源可以立即解决的问题提供解决方案。

注意

由 Amazon Bedrock 提供支持： AWS 实现自动滥用检测。由于 “为我写描述”、“创建内容摘要”、“推荐任务”、“使用 Amazon Q 为项目创建或添加功能” 以及 “使用 Amazon Q 开发者代理向 Amazon Q 分配问题” 功能是在 Amazon Bedrock 上构建的，因此用户可以充分利用 Amazon Bedrock 中实施的控制措施来加强安全、保障和负责任地使用人工智能 (AI)。

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

重要

生成式 AI 功能仅在美国西部（俄勒冈）地区可用。

  • 使用 Amazon Q 提供的默认提示。Amazon Q 最擅长从提供的提示中选择蓝图。

  • 使用 Amazon Q 建议的配置选项来预览蓝图。选择蓝图以预览该蓝图将创建的示例代码和资源。

  • 使用为 Amazon Q 启用的空间。要使用 Amazon Q 创建项目，或者使用 Amazon Q 为带有蓝图的项目添加功能，请使用为生成式 AI 功能启用的空间。有关更多信息，请参阅为空间启用或禁用生成式 AI 功能。

  • 获取有关 Amazon Q 推荐的蓝图的更多信息。 您可能需要详细了解使用特定的推荐蓝图创建的项目资源、示例代码和组件。有关中可用蓝图的更多信息 CodeCatalyst，请参阅使用 CodeCatalyst 蓝图创建综合项目。

  • 允许 Amazon Q 处理问题。允许 Amazon Q 为您创建问题、分配这些问题并对其进行跟踪。有关更多信息，请参阅 教程：使用 CodeCatalyst 生成式 AI 功能加快开发工作。

  • 取消将 Amazon Q 从已停止处理的问题中解除分配。完成示例后，取消分配 Amazon Q 以解决任何不再处理的问题。如果 Amazon Q 已完成问题工作或找不到解决方案，请务必取消分配 Amazon Q，以免达到生成人工智能功能的最大配额。有关更多信息，请参阅管理生成式 AI 功能和定价。

  • 查看 Amazon Q 的使用情况 您可以在用户层面查看生成式 AI 功能的使用情况。前往 “我的设置”，管理生成式 AI 配额，并按您的生成器 ID 或单点登录 (SSO) 身份查看使用情况。有关更多信息，请参阅查看空间中生成式 AI 功能的使用情况。

重要

中的生成式 AI 功能 CodeCatalyst 受配额限制。有关更多信息，请参阅 Amazon Q 开发者定价、为空间启用或禁用生成式 AI 功能和账单。

在项目中使用蓝图的最佳实践

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

  • 使用提供的 CodeCatalyst 蓝图创建项目或将其添加到项目中。您可以使用蓝图为开发者创建包含源代码和资源的完整项目。例如，Web 应用程序蓝图创建应用程序和基础架构资源并部署 Web 应用程序。您可以使用蓝图创建项目，也可以向现有项目添加自定义蓝图。有关更多信息，请参阅 使用蓝图创建项目。在中 CodeCatalyst 查看任何蓝图，预览蓝图将创建的示例代码和资源。

  • 使用您的组织设计的自定义蓝图。您可以使用自定义蓝图在自己的空间中创建完整的项目。您的组织设计的自定义蓝图可以提供标准化和最佳实践，这也有助于减少建立新项目的工作量。作为自定义蓝图作者，您可以查看有关整个空间中哪些项目正在使用您的蓝图的详细信息。生命周期管理允许您集中管理每个项目的软件开发生命周期，蓝图用户可以利用生命周期管理从蓝图的更新选项或版本中重新生成代码库。有关更多信息，请参阅 以蓝图作者的身份参与生命周期管理。

  • 将开发者角色或相应IAM角色添加到项目的账户中。在完成项目创建步骤期间或之后，您可以通过选择或创建与空间相连的IAM AWS 账户 角色来配置蓝图权限。

向已创建的项目添加资源和任务

项目准备就绪后，您可以添加资源和任务。