設定外部服務的分支原則

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

分支原則是一項功能強大的功能，可藉由建立所有提取要求的需求，以確保存放庫中的高品質程序代碼。 外部服務可以使用 PR 狀態 API ，將詳細狀態張貼到您的 PR。 外部服務的分支原則可讓第三方服務參與PR工作流程，並建立原則需求。 本文會引導您完成為張貼PR狀態之服務的分支原則設定程式。 如需PR狀態的詳細資訊，請參閱 使用提取要求狀態自定義和擴充提取要求工作流程。

必要條件

• Azure DevOps 中具有 Git 存放庫的組織。 如果您沒有組織， 請註冊 以免費無限制的私人 Git 存放庫上傳和共用程序代碼。
• 將狀態張貼至PR的服務。 請參閱 建立提取要求狀態伺服器。

設定分支原則

1. 流覽至 [ 程序代碼>分支 ]，並尋找您想要設定原則的分支（通常是 main 或 develop）。 從操作功能表中，選取 [ 分支原則] 選項。

   

2. 向下捲動以尋找 狀態檢查。 選取 + 按鈕。

   

3. 從清單中選取您想要建立原則的服務。 如果先前已張貼狀態，您可以從清單中挑選它;如果是新原則，您可以輸入原則的名稱。

   

   • 原則需求 會決定此原則是否為選擇性或必要，才能完成提取要求至分支。
   • 授權的身分 識別是用來強制執行來自指定身分識別的狀態，將會計入原則履行。
   • 重設條件 可用來判斷張貼狀態何時不再有效。 如果張貼的狀態是最新的程式碼所特有（也就是組建），每當有新的變更時，檢查 [重設狀態] 以重設來源分支變更時的狀態。
   • 選擇性地設定 路徑篩選條件。 深入瞭解 分支原則中的路徑篩選 。
   • 原則適用性 會決定此原則會在建立提取要求時立即套用，或原則是否只在第一個狀態張貼至提取要求之後才會套用。
   • 默認顯示名稱 可讓您指定原則的選擇性顯示名稱。

建立新的提取要求

1. 在定義原則的分支中建立新的提取要求。 如需詳細資訊，請參閱 建立提取要求。

2. 建立PR之後，新的原則會出現在PR詳細數據檢視的 [原則] 區段中。 一開始，在外部服務張貼狀態之前，原則會顯示為未設定。

   

   當服務張貼狀態時，原則會據以更新。 完成將會遭到封鎖，直到原則核准PR為止。

   

   符合原則準則，且服務張貼 succeeded 狀態時，PR 將會獲得核准，並解除封鎖完成。

   

摘要

在本文中，您已瞭解如何設定外部服務的分支原則。