連接原始碼服務

讓你的代理人員存取資料庫、問題和拉取請求的上下文，方便調查。 它能讀取近期變更、尋找相關問題，並在你提供的憑證允許時，在正確的倉庫或專案中開啟問題或拉取請求。

這個教學涵蓋了 GitHub、Azure DevOps 和 GitLab。 原始碼連線使用 程式碼存取 頁面（建構 > 程式碼存取），而非管理連接器精靈。 本文聚焦於原始碼細節：每個服務如何認證以及如何驗證連線。

先決條件

  • 一個正在運行的 SRE 代理程式和存取 sre.azure.com。
  • 設定代理程式的權限。
  • 服務中擁有存取倉庫或專案權限的帳號，代理人應該閱讀。

關於通知服務，請參閱 「連接通知服務」。

原始碼連接器

連接器 服務 Authentication 典型用途
GitHub GitHub 與 GitHub 企業雲 自帶GitHub應用程式（OAuth 與 PAT 也支援 github.com） 閱讀專案與組織間的資料庫、議題與拉取請求;建立問題或拉取請求並獲得批准
Azure DevOps Azure DevOps 管理身份（同時支援 OAuth 與 PAT） 跨專案閱讀資料庫與拉取請求;建立拉取請求或工作項目，並獲得批准
GitLab GitLab 個人存取權杖 （PAT） 閱讀資料庫、議題及合併請求;創造議題與評論並獲得認可

GitHub 和 Azure DevOps 將認證選項作為單選按鈕呈現。 GitLab 使用個人存取權杖。

步驟 1：開放程式碼存取

  1. 前往 sre.azure.com 選擇您的經紀人。
  2. 在左側邊欄，展開 「建構者」，然後選擇 「程式碼存取」。
  3. 選擇你服務的分頁（GitHub、Azure DevOps 或 GitLab）。
  4. 選擇 新增儲存庫。

步驟 2：認證

新增儲存庫對話框會以三步驟嚮導開啟：選擇平台→驗證→新增儲存庫。 每個步驟之後選取 \[下一步\]。 最後一步有一個 儲存 按鈕。

使用 Bring your own GitHub 應用程式來支援 GitHub 企業雲，或依組織或安裝範圍來擴大存取權限。

  1. 在登入方式中，選擇「帶入你自己的 GitHub 應用程式」。
  2. 完成向導顯示的應用程式設定欄位。
  3. 選取 下一步。

GitHub Enterprise Cloud （.ghe.com） 需要 GitHub 應用程式連線。 對於 github.com，也支援您的帳號（若為您的環境設定為 OAuth）或個人存取權杖，但生產場景中偏好 GitHub App 選項，以提供更細緻的權限與審計可視性。

連線後，代理可以搜尋你應用程式或帳號能存取的專案與組織的倉庫、問題和拉取請求。

服務會看到授權連線的身份。 代理所建立的問題、評論和拉取請求活動都會出現在該帳號下。

步驟 3：新增儲存庫

新增倉庫步驟會顯示一個表格，指定代理人索引的倉庫。 每一列都是一個儲存庫。

  1. 如果你的服務是Azure DevOps，請先從Azure DevOps Project下拉選單中選擇project。 Repository URL 欄位會填入該專案中的倉庫。

  2. 在 「儲存庫網址 」欄位，從下拉選單選擇儲存庫或直接輸入網址。 在 GitHub 和 GitLab 上，下拉選單會列出你的憑證可以存取的儲存庫。 對於 Azure DevOps，它會列出所選專案中的倉庫。

  3. 在 顯示名稱 欄位，輸入代理用來指稱儲存庫的簡短名稱。

  4. 可選擇填寫 描述 欄位，讓代理更了解儲存庫內容的背景。

  5. 如果你的服務是 Azure DevOps，且儲存庫非常大，請啟用遠端核取方塊。 代理人使用 AI 驅動的遠端副本搜尋，而非本地複製。 儲存庫以 100 GB 磁碟限制克隆;啟用遠端功能則避免了這個限制。

  6. 若要新增儲存庫，選擇 新增 並填入下一列。

  7. 表格完成後，選擇 儲存。

步驟四：用情境來驗證

  1. 和你的經紀人開個聊天。

  2. 提出一個閱讀問題，例如：

    List the open issues in the payments repository from the last week.

  3. 請查看工具卡，確認客服人員會搜尋服務並回傳有你資料基礎的結果。

當結果出現引用你的儲存庫時，連線就能端對端運作。

Troubleshooting

Problem Cause 修復
搜尋無結果 該帳號無法存取專案或儲存庫 確認連線帳號能看到專案或儲存庫，然後再試一次。
Create 失敗且出現權限錯誤 該代幣或帳戶缺乏寫入範圍 授予令牌或帳號所需的權限，或使用有寫入權限的憑證。
GitHub Enterprise Cloud 拒絕了該連線 GitHub Enterprise Cloud 需要 GitHub 應用程式連線 在程式碼存取頁面，斷開 GitHub 連線，選擇新增儲存庫，選擇 GitHub，輸入你的.ghe.com主機，並選擇「帶上你自己的 GitHub 應用程式」作為認證方式。

相關內容

  • Last updated on