連接
儲存庫
連接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審查與沙箱網路設定,說明如下。 |
| Observability | Polylane在每次同步後審視儲存庫,回報它的程式碼儀器化得多好:有多少路由處理器送出遙測、哪些完全沒有。每個發現都可以用Ask Polylane to fix it交給代理。 |
| Changes | 這個儲存庫的pull request審查歷史,每一次都對照生產拓樸檢查並給出通過或不通過的判定。 |
| Resources | 這個儲存庫管理的雲端資源。Polylane從部署清單與供應商中繼資料連結它們,偵測不到的則由你用Link resource加入。審查會把調查範圍限定在這些資源,在連結之前則回退到整個雲端帳戶。 |
| Properties | 原始的儲存庫記錄。 |
儲存庫設定
| 設定 | 它控制什麼 |
|---|---|
| Open autofix pull requests | Polylane是否把已確認的發現變成這個儲存庫上的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 allowlist | None、供套件登錄與語言生態系使用的Common dependencies,或All (unrestricted)。 |
相關頁面
- Pull request審查:審查檢查什麼,以及判定怎麼讀。
- Topology:儲存庫加入的那張圖。
- Autofix:Polylane對已連接儲存庫開啟的pull request。
- GitHub:App權限,以及中斷連接會移除什麼。