來源儲存庫概念 - Amazon CodeCatalyst

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

來源儲存庫概念

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

專案

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

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

來源儲存庫

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

開發環境

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

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

個人存取權杖 (PATs)

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

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

分支

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

預設分支

無論您如何建立來源儲存庫, 中的來源儲存庫 CodeCatalyst 都有預設分支。如果您選擇使用範本建立專案,則為該專案建立的來源儲存庫除了包含範例程式碼、工作流程定義和其他資源之外,還包含 README.md 檔案。如果您不使用範本建立來源儲存庫,則會為您新增 README.md 檔案作為第一次遞交,並為您建立預設分支作為建立儲存庫的一部分。此預設分支名為主要 。當使用者複製儲存庫時,此預設分支會用作本機儲存庫 (Repos) 中的基礎或預設分支。您可以變更哪個分支用作預設分支。如需詳細資訊,請參閱管理儲存庫的預設分支

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

遞交

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

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

提取請求

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

提示

當您建立提取請求時,所顯示的差異是來源分支的尖端與目的地分支的尖端之間的差異。建立提取請求後,所顯示的差異將介於您選擇的提取請求修訂與建立提取請求時目的地分支的遞交之間。如需 Git 中差異和合併基礎的詳細資訊,請參閱 Git 文件git-merge-base中的 。

修訂

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

工作流程

工作流程是一種自動化程序,說明如何建置、測試和部署程式碼,作為持續整合和持續交付 (CI/CD) 系統的一部分。工作流程定義了工作流程執行期間要採取的一系列步驟或動作 。工作流程也會定義導致工作流程啟動的事件或觸發條件 。若要設定工作流程,您可以使用 CodeCatalyst 主控台的視覺效果或YAML編輯器 建立工作流程定義檔案

提示

若要快速了解如何在專案中使用工作流程,請使用藍圖 建立專案。每個藍圖都會部署功能正常的工作流程,供您檢閱、執行和實驗。

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