Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022
分支原則是一項強大的功能，可藉由建立所有提取要求的需求來確保存放庫中的高品質程式碼。 外部服務可以使用 PR 狀態 API ，將詳細狀態張貼至 PR。 外部服務的分支原則可讓這些第三方服務參與 PR 工作流程並建立原則需求。 本文會引導您完成為張貼 PR 狀態之服務的分支原則設定程式。 如需 PR 狀態的詳細資訊，請參閱 使用提取要求狀態自訂和擴充提取要求工作流程。
先決條件
| 類別 | 需求 |
|---|---|
| 專案存取 | 專案的成員。 |
| 許可 | - 檢視私人專案中的程式碼：至少具有 基本 存取權。 - 複製或參與私人專案中的程式碼： 參與者 安全性群組的成員或專案中的對應許可權。 - 設定分支或存放庫權限：管理分支或存放庫的 許可 權權限。 - 變更預設分支：編輯存放庫的 原則 權限。 - 匯入存放庫： 專案系統管理員安全性 群組的成員或 Git 專案層級 建立存放庫 許可權設定為 [允許]。 如需詳細資訊，請參閱 設定 Git 存放庫許可權。 |
| Services | 已啟用 Repos。 |
| Tools | 選擇性。 使用 az repos 命令： Azure DevOps CLI。 |
備註
在公用專案中，具有 專案關係人 存取權的使用者具有 Azure Repos 的完整存取權，包括檢視、複製和參與程式代碼。
設定分支原則
流覽至 [程式碼>分支] ，然後尋找您要設定原則的分支 （通常是
main或develop）。 從內容功能表中，選取 [分支原則 ] 選項。
向下捲動以尋找 狀態檢查。 選取按鈕 + 。
![選取 [新增原則] 按鈕](media/pr-status-policy/add-service.png?view=azure-devops)
從清單中選取您要為其建立原則的服務。 如果先前已張貼狀態，您可以從清單中挑選它;如果是新原則，您可以輸入原則名稱。
- 原則需求 會決定此原則是否為選擇性或必要，才能完成分支的提取要求。
- 授權身分可用 來強制執行只有指定身分的狀態才會計入原則履行。
- 重設條件可用 來判斷已張貼狀態何時不再有效。 如果張貼的狀態特定於最新程式碼（即組建），請核取 每當有新變更時重設狀態 ，以在來源分支變更時重設狀態。
- 選擇性地設定 路徑篩選器。 深入瞭解分支原則中的 路徑篩選 器。
- 原則適用性 會決定此原則是否在建立提取要求後立即套用，或原則是否只在第一個狀態張貼至提取要求之後套用。
- 預設顯示名稱可讓您 為原則指定選用的顯示名稱。
建立新的提取要求
在定義原則的分支中建立新的提取要求。 如需詳細資訊，請參閱 建立提取請求。
建立 PR 之後，新的原則會出現在 PR 詳細資料檢視的 [原則] 區段中。 一開始，原則會顯示為未設定，直到外部服務張貼狀態為止。
當服務發布狀態時，政策將相應更新。 完成將會封鎖，直到原則核准 PR。
當符合原則準則，且服務張貼
succeeded狀態時，將會核准 PR，並解除封鎖完成。
總結
在本文中，您已瞭解如何設定外部服務的分支原則。