Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 來源儲存庫概念
<a name="source-concepts"></a>

以下是使用 CodeCatalyst 來源儲存庫時需要了解的一些概念。

**Topics**
+ [專案](#project-concept)
+ [來源儲存庫](#source-repository-concept)
+ [開發環境](#devenvironment-concept)
+ [個人存取字符 (PATs)](#personal-access-token-concept)
+ [分支](#branches-concept)
+ [預設分支](#default-branch-concept)
+ [遞交](#commits-concept)
+ [提取請求](#pull-request-concept)
+ [修訂](#revision-concept)
+ [工作流程](#workflow-concept)

## 專案
<a name="project-concept"></a>

*專案*代表 CodeCatalyst 中的協作工作，支援開發團隊和任務。擁有專案之後，您可以新增、更新或移除使用者和資源、自訂專案儀表板，以及監控團隊工作的進度。您可以在空間中擁有多個專案。

來源儲存庫專屬於您在空間中建立或連結它們的專案。您無法在專案之間共用儲存庫，也無法將儲存庫連結至空間中的多個專案。在專案中具有**貢獻者**或**專案管理員**角色的使用者，可以根據授予這些角色的許可，與該專案相關聯的來源儲存庫互動。如需詳細資訊，請參閱[使用使用者角色授予存取權](ipa-roles.md)。

## 來源儲存庫
<a name="source-repository-concept"></a>

*來源儲存庫*可讓您安全地存放專案的程式碼和檔案。它也會儲存檔案的版本歷史記錄。根據預設，來源儲存庫會與 CodeCatalyst 專案中的其他使用者共用。您可以為專案擁有多個來源儲存庫。您可以在 CodeCatalyst 中為專案建立來源儲存庫，或者如果已安裝的延伸模組支援該服務，您可以選擇連結由其他服務託管的現有來源儲存庫。例如，您可以在安裝 GitHub 儲存庫延伸模組後，將 **GitHub 儲存庫**連結至專案。如需詳細資訊，請參閱[將原始程式碼存放在 CodeCatalyst 中專案的儲存庫中](source-repositories.md)及[快速入門：在 CodeCatalyst 中安裝擴充功能、連線供應商和連結資源](extensions-quickstart.md)。

## 開發環境
<a name="devenvironment-concept"></a>

*開發環境*是一種雲端型開發環境，您可以在 CodeCatalyst 中使用它來快速處理儲存在專案來源儲存庫中的程式碼。開發環境中包含的專案工具和應用程式程式庫是由專案來源儲存庫中的 devfile 所定義。如果您的來源儲存庫中沒有 devfile，則會自動套用預設 devfile。預設 devfile 包含最常使用的程式設計語言和架構的工具。根據預設，開發環境設定為具有 2 核心處理器、4 GB RAM 和 16 GiB 的持久性儲存。

您可以選擇將來源儲存庫的現有分支複製到開發環境，也可以選擇建立新的分支，做為建立開發環境的一部分。

## 個人存取字符 (PATs)
<a name="personal-access-token-concept"></a>

*個人存取字符* (PAT) 類似於密碼。它與您的使用者身分相關聯，可用於 CodeCatalyst 中的所有空間和專案。您可以使用 PATs存取 CodeCatalyst 資源，其中包含整合式開發環境 (IDEs) 和 Git 型來源儲存庫。PATs CodeCatalyst 中代表您，您可以在使用者設定中管理它們。使用者可以有多個 PAT。個人存取字符只會顯示一次。根據最佳實務，請務必將它們安全地存放在本機電腦上。根據預設，PATs會在一年後過期。

使用整合式開發環境 (IDEs) 時，PATs等同於 Git 密碼。設定 IDE 以使用 Git 儲存庫時，請在要求密碼時提供 PAT。如需如何將 IDE 與 Git 型儲存庫連線的詳細資訊，請參閱 IDE 的文件。

## 分支
<a name="branches-concept"></a>

*分支*是 Git 和 CodeCatalyst 中遞交的指標或參考。您可以使用分支來組織您的工作。例如，您可以使用分支來處理新版本或不同版本的檔案，而不會影響其他分支中的檔案。您可以使用分支來開發新功能、存放專案的特定版本等等。來源儲存庫可以有一個分支或多個分支。當您使用範本建立專案時，為專案建立的來源儲存庫會在稱為**主要**的分支中包含範例檔案。**主要**分支是儲存庫的預設分支。

## 預設分支
<a name="default-branch-concept"></a>

CodeCatalyst 中的來源儲存庫具有預設分支，無論您如何建立它們。如果您選擇使用範本建立專案，則為該專案建立的來源儲存庫除了包含範例程式碼、工作流程定義和其他資源之外，還包含 README.md 檔案。如果您在不使用範本的情況下建立來源儲存庫，則會為您新增 README.md 檔案做為第一個遞交，並在建立儲存庫時為您建立預設分支。此預設分支名為 *main*。此預設分支是在使用者複製儲存庫時，用作本機儲存庫 （儲存庫） 中基本或預設分支的分支。您可以變更哪個分支用作預設分支。如需詳細資訊，請參閱[管理儲存庫的預設分支](source-branches-default-branch.md)。

您無法刪除來源儲存庫的預設分支。搜尋結果僅包含預設分支的結果。

## 遞交
<a name="commits-concept"></a>

*遞交*是檔案或一組檔案的變更。在 Amazon CodeCatalyst 主控台中，遞交會儲存您的變更，並將其推送至來源儲存庫。遞交包含變更的相關資訊，包括進行變更的使用者身分、變更的時間和日期、遞交標題，以及任何包含變更的訊息。如需詳細資訊，請參閱[了解 Amazon CodeCatalyst 中具有遞交的原始程式碼變更](source-commits.md)。

在 CodeCatalyst 中的來源儲存庫內容中，遞交是內容的快照，以及儲存庫內容的變更。您也可以將 Git 標籤新增至遞交，以識別特定遞交。

## 提取請求
<a name="pull-request-concept"></a>

*提取請求*是您和其他使用者檢閱、評論和合併來源儲存庫中從一個分支到另一個分支程式碼變更的主要方式。您可以使用提取請求，針對發行軟體的次要變更或修正、主要功能新增或新版本，協同檢閱程式碼變更。在提取請求中，您可以檢閱來源和目的地分支之間的變更，或這些分支修訂之間的差異。您可以新增個別程式碼變更行的註解，以及對提取請求整體的註解。

**提示**  
當您建立提取請求時，所顯示的差異是來源分支的尖端與目的地分支的尖端之間的差異。建立提取請求後，所顯示的差異將是您選擇的提取請求修訂與建立提取請求時目的地分支頂端的遞交之間。如需 Git 中差異和合併基礎的詳細資訊，請參閱 Git 文件中的 [git-merge-base](https://git-scm.com/docs/git-merge-base)。

## 修訂
<a name="revision-concept"></a>

*修訂*是提取請求的更新版本。每個推送到提取請求的來源分支都會建立修訂，其中包含該推送中包含在遞交中所做的變更。除了來源和目的地分支之間的差異之外，您還可以檢視提取請求修訂之間的差異。如需詳細資訊，請參閱[在 Amazon CodeCatalyst 中使用提取請求檢閱程式碼](source-pull-requests.md)。

## 工作流程
<a name="workflow-concept"></a>

*工作流程*是一種自動化程序，說明如何建置、測試和部署程式碼，做為持續整合和持續交付 (CI/CD) 系統的一部分。工作流程定義了工作流程執行期間要採取的一系列步驟或*動作*。工作流程也會定義導致工作流程啟動的事件或*觸發條件*。若要設定工作流程，您可以使用 CodeCatalyst 主控台的[視覺化或 YAML 編輯器](https://docs.aws.amazon.com//codecatalyst/latest/userguide/flows.html#workflow.editors)建立*工作流程定義檔案*。

**提示**  
若要快速了解如何在專案中使用工作流程，[請使用藍圖建立專案](https://docs.aws.amazon.com//codecatalyst/latest/userguide/projects-create.html#projects-create-console-template)。每個藍圖都會部署可檢閱、執行和實驗的正常運作工作流程。

來源儲存庫也可以儲存組態檔案和其他資訊，用於專案的工作流程、通知、問題和其他組態資訊。當您建立需要組態檔案的資源，或將儲存庫指定為工作流程的來源動作時，組態檔案會建立並存放在來源儲存庫中。如果您從藍圖建立專案，您的組態檔案會儲存在專案中為您建立的來源儲存庫中。此組態資訊會儲存在儲存庫預設分支`.codecatalyst`中名為 的資料夾中。每當您建立預設分支的分支時，除了該分支中的所有其他檔案和資料夾之外，還會建立此資料夾及其組態的副本。