使用分支規則管理分支的允許動作 - Amazon CodeCatalyst

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

使用分支規則管理分支的允許動作

當您建立分支時，根據該角色的許可，該分支允許某些動作。您可以透過設定分支規則來變更特定分支允許的動作。分支規則是以使用者在專案中的角色為基礎。您可以選擇將一些預先定義的動作限制在專案中具有特定角色的使用者，例如推送遞交至分支。這可以透過限制哪些角色可以執行某些動作，協助您保護專案中的特定分支。例如，如果您將分支規則設定為僅允許具有專案管理員角色的使用者合併或推送至該分支，則具有專案中其他角色的使用者將無法變更該分支中的程式碼。

您應該仔細考慮為分支建立規則的所有影響。例如，如果您選擇限制向具有專案管理員角色的使用者推送分支，則具有貢獻者角色的使用者將無法在該分支中建立或編輯工作流程，因為工作流程YAML存放在該分支中，且這些使用者無法將變更遞交和推送至 YAML。作為最佳實務，請在建立分支規則後對其進行測試，以確保它們不會對您不打算造成任何影響。您也可以將分支規則與提取請求的核准規則搭配使用。如需詳細資訊，請參閱管理將提取請求與核准規則合併的要求。

注意

您必須具有專案管理員角色，才能管理 CodeCatalyst 專案中來源儲存庫的分支規則。您無法為連結的儲存庫建立分支規則。

您只能建立比角色預設許可更嚴格的分支規則。您無法建立比使用者在專案中的角色允許的更寬鬆的分支規則。例如，您無法建立允許具有檢閱者角色的使用者推送至分支的分支規則。

套用至來源儲存庫預設分支的分支規則的行為，與其他套用至其他分支的分支規則略有不同。套用至預設分支的任何規則都會自動套用至您指定為預設分支的任何分支。先前設定為預設分支的分支仍會保留套用至它的規則，但不再具有刪除保護。該保護僅適用於目前的預設分支。

分支規則有兩種狀態：標準 和自訂 。標準表示分支上允許的動作，是符合使用者在分支動作中具有 CodeCatalyst 之角色許可的動作。若要進一步了解哪些角色具有哪些許可，請參閱 使用使用者角色授予存取權。自訂表示一或多個分支動作具有特定角色清單的動作，該角色清單允許執行該動作，該動作與專案中使用者角色授予的預設許可不同。

注意

如果您建立分支規則來限制分支的一或多個動作，則刪除分支動作會自動設定為僅允許具有專案管理員角色的使用者刪除該分支。

下表列出允許在分支上執行這些動作之角色的動作和預設設定。

分支動作和角色
分支動作

未套用分支規則時，允許執行此動作的角色

合併至分支 （包括合併提取請求至分支）

專案管理員、貢獻者

推送至分支

專案管理員、貢獻者

刪除分支

專案管理員、貢獻者

刪除分支 （預設分支）

不允許

您無法刪除分支規則，但您可以更新這些規則，以允許來自允許在分支上執行此動作之所有角色的動作，從而有效地移除規則。

注意

您必須具有專案管理員角色，才能設定 CodeCatalyst 專案中來源儲存庫的分支規則。這不適用於連結的儲存庫。連結的儲存庫不支援 中的分支規則 CodeCatalyst。

檢視和編輯儲存庫的分支規則

  1. 導覽至儲存庫所在的專案。

  2. 從專案的來源儲存庫清單中選擇儲存庫的名稱。或者，在導覽窗格中，選擇程式碼 ，然後選擇來源儲存庫 。

    選擇您要檢視分支規則的儲存庫。

  3. 在儲存庫的概觀頁面上，選擇分支 。

  4. 在分支規則欄中，檢視儲存庫每個分支的規則狀態。標準表示分支動作的規則是來源儲存庫中建立的任何分支的預設規則，並符合專案中授予這些角色的許可。自訂表示一或多個分支動作具有將該分支允許的一或多個動作限制為不同角色集的規則。

    若要檢視分支規則的詳細資訊，請選擇您要檢閱的分支旁的標準或自訂一詞。

  5. 若要建立或變更分支規則，請選擇管理設定 。在來源儲存庫的設定頁面上，在分支規則 中，選擇編輯 。

  6. 在分支 中，從下拉式清單中選擇您要為其設定規則的分支名稱。對於每個允許的動作類型，從下拉式清單中選擇您要允許執行該動作的角色，然後選擇儲存 。