用途:在 Azure DevOps 專案範圍內,透過 REST API 查看與排查 Pipeline 建置,包括列出某個 Pipeline 定義的近期建置、查詢單一建置的狀態與結果、檢視失敗步驟的記錄檔,以及列出建置包含的變更。
連線與驗證:以 curl 直接呼叫 Azure DevOps REST API。組織讀取環境變數 AZURE_DEVOPS_ORG;權杖使用基本驗證 -u ":$AZURE_DEVOPS_PAT",僅設定 AZURE_DEVOPS_EXT_PAT 時改用該變數,改用 Microsoft Entra ID 權杖時為 -H "Authorization: Bearer $AZURE_DEVOPS_TOKEN"。權杖只從環境變數讀取,不要貼進對話或寫入檔案。所需 PAT 權限為 Build (Read)、Project and Team (Read)。專案與 Pipeline 名稱需 URL 編碼,查詢字串中的 $ 寫成 %24。
主要操作:列出近期建置使用 _apis/build/builds 並以 definitions 篩選,可加 branchName、statusFilter、resultFilter;查單一建置用 _apis/build/builds/{buildId};查失敗記錄檔先取 timeline,找 result 為 failed 的紀錄,再用 logs/{logId} 取內容(可只保留末段);查變更用 _apis/build/builds/{buildId}/changes。
呈現:建置清單以表格呈現建置 ID、定義名稱、狀態、結果、來源分支、開始時間與要求者;單一建置另加結束時間、建置編號與耗時;變更以表格呈現 Commit ID、作者、訊息與時間。時間以使用者當地時區顯示,無法判斷時標明 UTC。
限制:使用者未指定專案或 Pipeline 定義而問題需要時,需先請其提供一次,仍未提供則列出讓使用者選擇。HTTP 401、403、203 或回應為 HTML 登入頁代表權杖無效、過期或權限不足,須回報後停止;404 代表組織、專案或建置 ID 有誤。Windows PowerShell 需呼叫 curl.exe 並用 $env: 讀環境變數,且先將 JSON 主體寫入暫存檔再以 --data-binary "@body.json" 送出。觸發 Pipeline 需改用其他方式,本技能未提供。