共用方式為


設定外部服務的分支原則

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

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

必要條件

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

設定分支原則

  1. 流覽至 [ 程序代碼>分支 ],並尋找您想要設定原則的分支(通常是 maindevelop)。 從操作功能表中,選取 [ 分支原則] 選項。

    從操作功能表中選取分支原則

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

    選取 [新增原則] 按鈕

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

    從清單中選取原則

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

建立新的提取要求

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

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

    原則區段中會顯示原則狀態

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

    原則狀態更新

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

    已核准原則狀態並解除封鎖完成

摘要

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