源存储库概念

以下是您在使用 CodeCatalyst 源存储库时需要了解的一些概念。

项目

项目代表一种为开发团队和任务提供支持的协作努力。 CodeCatalyst 创建项目后，您可以添加、更新或删除用户和资源，自定义项目仪表板，并监控团队的工作进度。一个空间内可以有多个项目。

源存储库特定于您在空间中创建或链接源存储库的项目。您不能在项目之间共享存储库，也不能将存储库链接到空间中的多个项目。在项目中具有参与者或项目管理员角色的用户可以根据向这些角色授予的权限与与该项目关联的源存储库进行交互。有关更多信息，请参阅 使用用户角色授予访问权限。

源存储库

源存储库是您安全地存储项目代码和文件的地方。它还存储文件的版本历史记录。默认情况下，源存储库与 CodeCatalyst 项目中的其他用户共享。一个项目可以有多个源存储库。您可以为中的项目创建源存储库 CodeCatalyst，也可以选择链接其他服务托管的现有源存储库（如果已安装的扩展程序支持该服务）。例如，在安装 GitHub 存储库扩展之后，您可以将GitHub 存储库链接到项目。有关更多信息，请参阅 将源代码存储在项目的存储库中 CodeCatalyst 和 快速入门：安装扩展、连接提供商和链接资源 CodeCatalyst。

开发环境

开发环境是一种基于云的开发环境，您可以使用它 CodeCatalyst 来快速处理存储在项目源存储库中的代码。开发环境中包含的项目工具和应用程序库由项目源存储库中的开发文件定义。如果您的源存储库中没有开发文件，则会自动应用默认的开发文件。默认的 devfile 包括适用于最常用的编程语言和框架的工具。默认情况下，开发环境配置为具有 2 核处理器、4 GB RAM 和 16 GiB 永久存储空间。

您可以选择将源存储库的现有分支克隆到开发环境中，也可以选择在创建开发环境的过程中创建新分支。

个人访问令牌 (PAT)

个人访问令牌 (PAT) 类似于密码。它与您的用户身份相关联，可在中的所有空间和项目中使用 CodeCatalyst。您可以使用 PAT 访问 CodeCatalyst 资源，包括集成开发环境 (IDE) 和基于 Git 的源存储库。PAT 代表你 CodeCatalyst ，你可以在用户设置中对其进行管理。一个用户可以拥有多个 PAT。个人访问令牌仅显示一次。作为最佳实践，请务必将其安全地存储在本地计算机上。默认情况下，PAT 将在一年后过期。

在使用集成开发环境 (IDE) 时，PAT 等同于 Git 密码。在设置 IDE 以使用 Git 存储库时，如果要求输入密码，请提供 PAT。有关如何将 IDE 与基于 Git 的存储库连接的更多信息，请参阅 IDE 的文档。

Branches

分支是指向 Git 和中的提交的指针或引用 CodeCatalyst。你可以使用分支来组织你的工作。例如，您可以使用分支来处理新版本或不同版本的文件，而不会影响其他分支中的文件。您可以使用分支来开发新功能、存储项目的特定版本等。一个源存储库可以有一个或多个分支。使用模板创建项目时，为该项目创建的源存储库包含名为 main 的分支中的示例文件。主分支是存储库的默认分支。

默认分支

无论您如何创建，中的源存储库都 CodeCatalyst 有一个默认分支。如果您选择使用模板创建项目，则为该项目创建的源存储库除了示例代码、工作流程定义和其他资源外，还包括一个 README.md 文件。如果您在不使用模板的情况下创建源存储库，则会在首次提交时为您添加一个 README.md 文件，并在创建存储库的过程中为您创建一个默认分支。这个默认分支名为 main。此默认分支在用户克隆存储库时被用作本地存储库的基本或默认分支。您可以更改哪个分支用作默认分支。有关更多信息，请参阅 管理仓库的默认分支。

您无法删除源存储库的默认分支。搜索结果仅包括来自默认分支的结果。

提交

提交是对一个或一组文件的更改。在 Amazon CodeCatalyst 控制台中，提交会保存您的更改并将其推送到源存储库。提交包含有关变更的信息，包括进行更改的用户的身份、更改的时间和日期、提交标题以及包含的有关变更的任何消息。有关更多信息，请参阅 通过在 Amazon 中提交来了解源代码的变化 CodeCatalyst。

在中的源存储库的上下文中 CodeCatalyst，提交是存储库内容和内容更改的快照。您还可以在提交中添加 Git 标签，以识别特定的提交。

拉取请求

拉取请求是您和其他用户在源存储库中查看、评论和将代码更改从一个分支合并到另一个分支的主要方式。您可以使用拉取请求以协作方式查看代码更改，以了解已发布软件的细微更改或修复、主要功能添加或新版本。在拉取请求中，您可以查看源分支和目标分支之间的更改或这些分支的修订版之间的差异。您可以为各行代码更改添加注释，也可以对整个拉取请求添加评论。

提示

在创建拉取请求时，显示的区别是源分支的尖端和目标分支的尖端之间的区别。创建拉取请求后，显示的区别将是您选择的拉取请求的修订版和创建拉取请求时作为目标分支提示的提交。有关 Git 中的差异和合并基础的更多信息，请参阅 Git 文档git-merge-base中的。

修订

修订版是拉取请求的更新版本。每次推送到拉取请求的源分支都会创建一个修订版，其中包含在该推送中包含的提交中所做的更改。除了源分支和目标分支之间的差异外，您还可以查看拉取请求修订版之间的差异。有关更多信息，请参阅 在 Amazon 中使用拉取请求查看代码 CodeCatalyst。

工作流

工作流程是一个自动化过程，它描述了如何构建、测试和部署您的代码，作为持续集成和持续交付 (CI/CD) 系统的一部分。工作流程定义了在工作流程运行期间要执行的一系列步骤或操作。工作流程还定义了导致工作流程启动的事件或触发器。要设置工作流程，您可以使用 CodeCatalyst 控制台的可视化或 YAML 编辑器创建工作流程定义文件。

提示

要快速了解如何在项目中使用工作流程，请使用蓝图创建一个项目。每个蓝图都部署了一个可以正常运行的工作流程，您可以对其进行查看、运行和试验。

源存储库还可以存储项目的工作流程、通知、问题和其他配置信息的配置文件和其他信息。当您创建需要配置文件的资源时，或者将存储库指定为工作流程的源操作时，配置文件将创建并存储在源存储库中。如果您根据蓝图创建项目，则配置文件将存储在作为项目一部分为您创建的源存储库中。此配置信息存储在存储库默认分支.codecatalyst中名为的文件夹中。每当您创建默认分支的分支时，除了该分支中的所有其他文件和文件夹外，还会创建该文件夹及其配置的副本。