在中使用提取請求AWS CodeCommit儲存庫 - AWS CodeCommit

AWS CodeCommit 不再提供給新客戶。的現有客戶 AWS CodeCommit 可以繼續正常使用服務。進一步了解"

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

在中使用提取請求AWS CodeCommit儲存庫

為了讓您和其他儲存庫使用者可以檢閱程式碼變更、做註解,以及從一個分支合併到另一個分支,提取請求是主要方式。您可以使用提取請求來共同檢閱程式碼變更,以了解已發行軟體的次要變更或修正、新增的主要功能或新版本。以下是提取請求的一個可能的工作流程:

在名為的儲存庫中工作的開發人員 Li Juan,需要為即將發 MyDemoRepo 的產品版本開發新功能。為了將她的工作與可正式運作的程式碼分開,她在預設分支以外再建立一個分支,並命名為 feature-randomizationfeature。她撰寫程式碼、進行遞交,然後將新功能程式碼推送到這個分支。在將她的變更合併到預設分支之前,她希望其他儲存庫使用者能夠檢閱程式碼的品質。為了這樣做,她建立提取請求。提取請求包含她的工作分支與她想合併變更的程式碼分支 (在此案例中為預設分支) 之間的比較。她也可以建立核准規則,要求指定數目的使用者核准其提取請求。她甚至可以指定使用者的核准集區。其他使用者檢閱她的程式碼和變更,並新增註解和建議。她可能根據註解而以程式碼變更來多次更新她的工作分支。每當她在 CodeCommit 中將變更推送到該分支時,她的變更就會納入提取請求中。在提取請求已開啟的情況下,她也可能納入預定目的地分支中已發生的變更,讓使用者確信他們檢閱的是相關情境下所有提議的變更。當她和檢閱者都感到滿意,且已滿足核准規則 (如果有的話) 的條件時,她或其中一位檢閱者可合併程式碼並關閉提取請求。

建立提取請求

提取請求需要兩個分支:來源分支 - 包含您希望檢閱的程式碼;目的地分支 - 在此處合併已檢閱的程式碼。來源分支包含「之後」遞交,此遞交包含您想要合併到目的地分支的變更。目的地分支包含「之前」遞交,這代表提取請求分支合併到目的地分支之前的程式碼狀態。合併策略的選擇會影響 CodeCommit 控制台中,提交在來源和目的地分支之間合併方式的詳細資訊。如需有關在 CodeCommit 中合併策略的詳細資訊,請參合併提取請求(主控台)

提取請求的來源和目的地分支,顯示之前和之後遞交之間的關係

提取請求會顯示建立提取請求時,在來源分支的頂端與目的地分支的最新遞交之間的差異,讓使用者可以檢視變更並做註解。您可以將變更遞交並推送到來源分支,以更新提取請求來回應註解。

對提取請求中的行新增評論。

在檢閱過您的程式碼,且已滿足核准規則需求 (如果有的話) 時,您可以使用下列其中一種方式來關閉提取請求:

  • 在本機合併分支並推送您的變更。這會自動關閉請求如果使用向前快轉合併策略並且沒有合併衝突。

  • 使用 AWS CodeCommit 主控台來關閉提取請求而不合併、解決合併中的衝突,或使用其中一個可用的合併策略來關閉和合併分支 (如果沒有衝突)。

  • 使用 AWS CLI。

在您建立提取請求之前:

  • 請確定已將您希望檢閱的程式碼變更遞交並推送到分支 (來源分支)。

  • 為儲存庫設定通知,讓其他使用者收到有關提取請求及其變更的通知。(此為選用步驟,但建議執行。)

  • 建立核准規則範本並與儲存庫建立關聯,以便為提取請求自動建立核准規則,以協助確保程式碼品質。如需詳細資訊,請參閱 使用核准規則範本

當您在 Amazon Web Services 賬户中為儲存庫用户設定 IAM 用户後,提取請求會更有效果。更容易識別哪個使用者發表哪個評論。另一個優點是使用者可以使用 Git 憑證存取儲存庫。如需詳細資訊,請參閱 步驟 1:初始配置 CodeCommit。您可以對其他類型的使用者 (包括聯合身分存取使用者) 使用提取請求。

如需有關在 CodeCommit 中使用儲存庫其他部分的資訊,請參使用儲存庫使用核准規則範本使用檔案使用遞交使用分支,以及使用者偏好設定