本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
以下是您在使用 CodeCatalyst 來源儲存庫時應了解的一些概念。
專案
專案代表 CodeCatalyst 中的協作工作,支援開發團隊和任務。擁有專案之後,您可以新增、更新或移除使用者和資源、自訂專案儀表板,以及監控團隊工作的進度。您可以在一個空間中擁有多個專案。
來源儲存庫專屬於您在空間中建立或連結它們的專案。您無法在專案之間共用儲存庫,也無法將儲存庫連結至空間中的多個專案。在專案中具有貢獻者或專案管理員角色的使用者,可以根據授予這些角色的許可,與該專案相關聯的來源儲存庫互動。如需詳細資訊,請參閱使用使用者角色授予存取權。
來源儲存庫
來源儲存庫可讓您安全地存放專案的程式碼和檔案。它也會儲存檔案的版本歷史記錄。根據預設,來源儲存庫會與 CodeCatalyst 專案中的其他使用者共用。您可以為專案擁有多個來源儲存庫。您可以為 CodeCatalyst 中的專案建立來源儲存庫,或者,如果已安裝的延伸模組支援該服務,您可以選擇連結由其他服務託管的現有來源儲存庫。例如,您可以在安裝 GitHub 儲存庫延伸模組後,將 GitHub 儲存庫連結至專案。如需詳細資訊,請參閱 在 CodeCatalyst 中將原始程式碼存放在專案的儲存庫中 和 快速入門:在 CodeCatalyst 中安裝延伸模組、連線供應商和連結資源。
開發環境
開發環境是一種雲端型開發環境,您可以在 CodeCatalyst 中使用它,快速處理存放在專案來源儲存庫中的程式碼。開發環境中包含的專案工具和應用程式程式庫是由專案來源儲存庫中的 devfile 所定義。如果您的來源儲存庫中沒有 devfile,則會自動套用預設 devfile。預設 devfile 包含最常使用的程式設計語言和架構的工具。根據預設,開發環境設定為具有 2 核心處理器、4 GB RAM 和 16 GiB 的持久性儲存。
您可以選擇將來源儲存庫的現有分支複製到開發環境,也可以選擇在建立開發環境時建立新的分支。
個人存取字符 (PATs)
個人存取字符 (PAT) 類似於密碼。它與您的使用者身分相關聯,可用於 CodeCatalyst 中的所有空間和專案。您可以使用 PATs存取 CodeCatalyst 資源,其中包含整合的開發環境 (IDEs) 和 Git 型來源儲存庫。PATs CodeCatalyst 中代表您,您可以在使用者設定中管理它們。使用者可以有多個 PAT。個人存取字符只會顯示一次。根據最佳實務,請務必將它們安全地存放在本機電腦上。根據預設,PATs會在一年後過期。
使用整合式開發環境 (IDEs) 時,PATs相當於 Git 密碼。在設定 IDE 以使用 Git 儲存庫時,在要求密碼時提供 PAT。如需如何將 IDE 與 Git 型儲存庫連線的詳細資訊,請參閱 IDE 的文件。
分支
分支是 Git 和 CodeCatalyst 中遞交的指標或參考。您可以使用分支來組織您的工作。例如,您可以使用分支來處理新版本或不同版本的檔案,而不會影響其他分支中的檔案。您可以使用分支來開發新功能、存放特定版本的專案等。來源儲存庫可以有一個分支或多個分支。當您使用範本建立專案時,為專案建立的來源儲存庫會在稱為主要的分支中包含範例檔案。主要分支是儲存庫的預設分支。
預設分支
CodeCatalyst 中的來源儲存庫具有預設分支,無論您如何建立它們。如果您選擇使用範本建立專案,則為該專案建立的來源儲存庫除了包含範例程式碼、工作流程定義和其他資源之外,還包含 README.md 檔案。如果您在不使用範本的情況下建立來源儲存庫,則會為您新增 README.md 檔案做為第一個遞交,並在建立儲存庫時為您建立預設分支。此預設分支名為 main。此預設分支是當使用者複製儲存庫時,用作本機儲存庫 (儲存庫) 中基本或預設分支的分支。您可以變更哪個分支用作預設分支。如需詳細資訊,請參閱管理儲存庫的預設分支。
您無法刪除來源儲存庫的預設分支。搜尋結果僅包含預設分支的結果。
遞交
遞交是檔案或一組檔案的變更。在 Amazon CodeCatalyst 主控台中,遞交會儲存您的變更,並將其推送至來源儲存庫。遞交包含有關變更的資訊,包括進行變更的使用者身分、變更的時間和日期、遞交標題,以及包含有關變更的任何訊息。如需詳細資訊,請參閱了解 Amazon CodeCatalyst 中具有遞交的原始程式碼變更。
在 CodeCatalyst 中的來源儲存庫內容中,遞交是內容的快照,以及儲存庫內容的變更。您也可以將 Git 標籤新增至遞交,以識別特定遞交。
提取請求
提取請求是您和其他使用者在來源儲存庫中檢閱、評論和合併從一個分支到另一個分支程式碼變更的主要方式。您可以使用提取請求,針對發行軟體的次要變更或修正、主要功能新增或新版本,協同檢閱程式碼變更。在提取請求中,您可以檢閱來源和目的地分支之間的變更,或這些分支修訂之間的差異。您可以新增個別程式碼變更行的註解,以及對提取請求整體的註解。
提示
當您建立提取請求時,所顯示的差異是來源分支的尖端與目的地分支的尖端之間的差異。建立提取請求後,所顯示的差異將介於您選擇的提取請求修訂與建立提取請求時目的地分支頂端的遞交之間。如需 Git 中差異和合併基礎的詳細資訊,請參閱 Git 文件中的 git-merge-base
修訂
修訂是提取請求的更新版本。每個推送到提取請求的來源分支都會建立修訂,其中包含該推送中包含的遞交中所做的變更。除了來源和目的地分支之間的差異之外,您還可以檢視提取請求修訂之間的差異。如需詳細資訊,請參閱在 Amazon CodeCatalyst 中使用提取請求檢閱程式碼。
工作流程
工作流程是一種自動化程序,說明如何建置、測試和部署程式碼,做為持續整合和持續交付 (CI/CD) 系統的一部分。工作流程會定義工作流程執行期間要採取的一系列步驟或動作。工作流程也會定義導致工作流程啟動的事件或觸發。若要設定工作流程,您可以使用 CodeCatalyst 主控台的視覺化或 YAML 編輯器建立工作流程定義檔案。
提示
若要快速了解如何在專案中使用工作流程,請使用藍圖建立專案。每個藍圖都會部署一個正常運作的工作流程,供您檢閱、執行和實驗。
來源儲存庫也可以儲存組態檔案和其他資訊,用於專案的工作流程、通知、問題和其他組態資訊。當您建立需要組態檔案的資源,或將儲存庫指定為工作流程的來源動作時,組態檔案會建立並存放在來源儲存庫中。如果您從藍圖建立專案,您的組態檔案會儲存在專案中為您建立的來源儲存庫中。此組態資訊會儲存在儲存庫預設分支.codecatalyst
中名為 的資料夾中。每當您建立預設分支的分支時,除了該分支中的所有其他檔案和資料夾之外,還會建立此資料夾及其組態的副本。