連接

儲存庫

連接GitHub,代理就能搜尋你的程式碼、執行它、審查每個pull request,並追蹤到它所部署的基礎設施。

連接儲存庫給代理你的原始碼。Polylane為它建立搜尋索引、在沙箱中執行它、對照生產環境審查每個pull request,並把儲存庫放在拓樸上、緊鄰它所部署的東西。

它做什麼

代理依關鍵字與語意搜尋程式碼,所以像「retry with exponential backoff」這樣的查詢即使這些字從未出現在原始碼中,也能落在正確的模組上。當調查需要時,它們會在沙箱中執行儲存庫的程式碼。每個pull request都會對照生產拓樸檢查,並以留言給出通過或不通過的判定。

在拓樸上,儲存庫是一個節點,透過deploys_to邊連到它所部署的資源,透過defines邊連到它的設定所佈建的資源。當代理調查某個服務上的問題時,它會沿著這些邊直接找到部署到那裡的程式碼。

連接儲存庫

在主控台開啟Settings > Repositories並選擇Add repository。Add from GitHub會在你的組織上安裝Polylane GitHub App,讓你挑選Polylane可以讀取哪些儲存庫;已連接的儲存庫會隨程式碼變更保持同步。

Add public repository以URL註冊一個公開的GitHub儲存庫。以這種方式加入的儲存庫不會在程式碼變更時自動更新,所以任何你正在積極開發的東西都請優先使用GitHub App。App權限請見GitHub。

儲存庫頁面

分頁它做什麼
Settings這個儲存庫的Autofix、pull request審查與沙箱網路設定,說明如下。
ObservabilityPolylane在每次同步後審視儲存庫,回報它的程式碼儀器化得多好:有多少路由處理器送出遙測、哪些完全沒有。每個發現都可以用Ask Polylane to fix it交給代理。
Changes這個儲存庫的pull request審查歷史,每一次都對照生產拓樸檢查並給出通過或不通過的判定。
Resources這個儲存庫管理的雲端資源。Polylane從部署清單與供應商中繼資料連結它們,偵測不到的則由你用Link resource加入。審查會把調查範圍限定在這些資源,在連結之前則回退到整個雲端帳戶。
Properties原始的儲存庫記錄。

儲存庫設定

設定它控制什麼
Open autofix pull requestsPolylane是否把已確認的發現變成這個儲存庫上的pull request。關閉會停止新的pull request;既有的pull request維持開啟。
Review pull requests for production impact是否對照生產拓樸調查每個pull request並給出判定留言。
Pull request review instructions給審查的儲存庫專屬指引,例如哪些路徑對部署至關重要,或哪些疑慮已由其他關卡處理。
Block merging on production concerns在每個受審查的pull request上發布一個「Polylane production impact」檢查,審查發現疑慮時該檢查會失敗。在分支保護中要求該檢查即可阻擋合併。預設開啟。
Agent internet access代理在執行程式碼時是否可以發出對外的網路請求。
Domain allowlistNone、供套件登錄與語言生態系使用的Common dependencies,或All (unrestricted)。

相關頁面

  • Pull request審查:審查檢查什麼,以及判定怎麼讀。
  • Topology:儲存庫加入的那張圖。
  • Autofix:Polylane對已連接儲存庫開啟的pull request。
  • GitHub:App權限,以及中斷連接會移除什麼。