將 GitHub 連結至 Azure Boards

  • 2 分鐘

GitHub 與 Azure Boards 之間的整合會建立強大的混合式方法，將 GitHub 的開發人員友善環境與 Azure Boards 的企業規劃功能結合。 這種連接使組織能夠維護集中式專案治理，同時允許開發團隊在他們喜歡的 GitHub 環境中工作。

整合的商業優勢：

  • 統一可見性： 利益相關者無需直接訪問 GitHub 即可追蹤開發進度
  • 合規和審計： 保持正式的項目追蹤，同時保留開發人員工作流程
  • 跨職能協作： 彌合項目經理和開發團隊之間的差距
  • 自動同步： 減少手動開銷，使項目狀態保持最新狀態

螢幕截圖顯示 Azure Boards 工作項目，已整合 GitHub 連結，直接在工作項目介面內顯示提交、拉取請求和問題。

Azure Boards 應用程式：整合基礎

Azure Boards 應用程式可作為技術橋樑，在 GitHub 和 Azure Boards 之間實現順暢的數據流程。 此市場應用程式提供安全、經過身份驗證的訪問，同時維護兩個平台的完整性。

關鍵整合能力：

  • 雙向連結：將 Azure Boards 工作專案與 GitHub 認可、PR 和問題連線
  • 自動化狀態轉換：當 GitHub 提及中包含「修正問題」等關鍵字時，即可完成工作項目。
  • 即時同步處理：GitHub 中的變更會立即反映在 Azure Boards 中
  • 靈活的範圍控制：選擇組織範圍或選擇性儲存庫整合

GitHub Marketplace 中 Azure Boards 應用程式安裝頁面的螢幕擷取畫面，顯示整合所需的設定選項和許可權。

安裝需求和權限

GitHub 必要條件：

  • 儲存庫存取權：目標儲存庫的管理員或擁有者權限
  • 組織權限：全組織安裝的擁有者角色
  • Marketplace 存取：能夠從 GitHub Marketplace 安裝應用程式

Azure DevOps 必要條件：

  • 專案集合系統管理員：初始連線設定的必要條件
  • 專案許可權：專案關係人存取權或更高，以檢視連結的工作專案
  • 驗證憑證：用於安全 API 存取的 PAT 或 OAuth

驗證和安全考量

安全身份驗證對於維護兩個平台上的資料完整性和存取控制至關重要。 Azure Boards 支援多種驗證方法，每種方法都有特定的安全性影響和使用案例。

GitHub 驗證選項：

方法 安全等級 適用對象 考量
個人存取權杖 High 自動化整合、CI/CD 需要仔細的範圍管理
使用者名稱/密碼 中等 個別使用者連線 安全性較低，不建議用於生產環境
OAuth 應用程式 High 組織範圍的整合 集中式存取管理

安全最佳實踐：

  • 最小權限原則：僅授予整合功能所需的權限
  • 代幣輪換：定期更新 PAT 並審查訪問權限
  • 稽核記錄：監控整合活動是否有異常存取模式
  • 存放庫隔離：只連線需要 Azure Boards 整合的存放庫

逐步連接過程：

  1. 從 GitHub Marketplace 安裝 Azure Boards 應用程式
  2. 設定存放庫存取 （所有存放庫或選擇性）
  3. 使用慣用的方法向 Azure DevOps 進行驗證
  4. 將存放庫對應至 Azure Boards 中的專案
  5. 使用範例連結和認可測試整合

如需詳細的實作指引，請參閱： 將 Azure Boards 連線到 GitHub

配置靈活性和管理

GitHub 端管理功能：

  • 存放庫範圍控制：在整合中新增或移除特定存放庫
  • 專案對應：設定哪些 Azure Boards 專案連線到每個存放庫
  • 整合暫停：暫時停用而不遺失配置
  • 完全刪除：卸載應用程序並刪除所有連接

Azure Boards端管理功能：

  • 多儲存庫連線：將多個 GitHub 儲存庫連結到單一專案
  • 跨專案連結：允許存放庫連線到多個 Azure Boards 專案
  • 連線健康監控：追蹤整合狀態並解決連線問題
  • 權限管理：控制哪些使用者可以修改 GitHub 連線

支援的整合案例

Azure Boards-GitHub 整合支援下列連線：

  • 透過 GitHub：

    • 支援整合 GitHub 帳戶或組織中所有的存放庫，或選擇特定的存放庫進行整合。
    • 新增或移除參與整合的 GitHub 存放庫，並設定其所連線的專案。
    • 暫停 Azure Boards-GitHub 整合或卸載應用程式。

  • 來自 Azure Boards：

    • 將一或多個 GitHub 存放庫連線到 Azure Boards 專案。
    • 從 Azure Boards 專案內的 GitHub 連線新增或移除 GitHub 存放庫。
    • 完全移除專案的 GitHub 連線。
    • 允許 GitHub 存放庫連線到相同 Azure DevOps 組織或集合內的一或多個 Azure Boards 專案。

Azure Boards-GitHub 整合支援下列作業工作：

  • 根據 GitHub 提及，建立工作項目與 GitHub 認可、提取要求和問題之間的連結。
  • 以 fix、fixes 或 fixed 使用 GitHub 提及時，工作項目的 [支援] 狀態轉換為 [已完成] 狀態。
  • 從工作項目連結至 GitHub 認可、提取要求或問題時，將討論留言張貼至 GitHub，支援完整追蹤。
  • 在工作項目 [開發] 區段中，顯示連結至 GitHub 程式碼成品。
  • 在工作流程看板卡片上，將連結至 GitHub 成品顯示為註釋。
  • 支援新增至 GitHub 存放庫的工作流程看板欄位狀態徽章。

目前不支援下列工作：

  • 查詢具有 GitHub 成品連結的工作項目。 不過，您可以使用大於 0 的外部連結計數來查詢工作專案。

注意

參考：Azure Boards-GitHub 整合。

如需詳細資訊，請參閱：