為什么你的規(guī)則集不生效一份 GHES 規(guī)則集啟用狀態(tài)排查指南【免費下載鏈接】docsThe open-source repo for docs.github.com項目地址: https://gitcode.com/GitHub_Trending/do/docs基于 GitHub Docs 倉庫docs.github.com 的開源項目講清楚規(guī)則集到底怎么工作評估和強制執(zhí)行有何區(qū)別、不同 GHES 版本各支持什么。規(guī)則集不生效時你會知道該查哪。規(guī)則明明開著推送怎么照樣過去了先別急著懷疑系統(tǒng)壞了很多時候只是配置里的一個細節(jié)沒對上。在動手改配置前花 30 秒核對下面幾件事規(guī)則集卡片上的狀態(tài)是不是綠色的 Active列表頁顯示的才是啟用狀態(tài)的真相灰色卡片說明它根本沒開目標分支真的覆蓋了你推送的分支嗎作用域沒對上它也會裝睡——目標是 main它管不到 feature 分支當前是評估模式還是強制執(zhí)行評估模式只記錄不攔截這是最容易被誤認為已啟用的狀態(tài)你自己在不在繞過名單里角色、團隊、應用都能繞過規(guī)則集放行你的推送的可能就是名單里的某個身份規(guī)則集是倉庫級還是組織級組織規(guī)則集在倉庫頁面只能看不能改你在倉庫頁的調整可能根本沒落下去核對完表面狀態(tài)我們再看水面下的機制——為什么顯示已啟用不等于真的在攔。規(guī)則集怎么工作兩種執(zhí)勤狀態(tài)把規(guī)則集想象成門口的保安他有兩種執(zhí)勤方式。評估模式像只登記保安盯著每個人、記下誰觸發(fā)了哪條規(guī)則但不動手攔人。它適合你剛配好新規(guī)則、想先看影響面再收網(wǎng)的階段。強制執(zhí)行才是真干活發(fā)現(xiàn)違規(guī)直接拒推。你在界面看到的已啟用其實是這兩種狀態(tài)的組合Active 加評估是保安在崗但只記小本本Active 加強制執(zhí)行才是真攔截。繼承關系是另一層邏輯。企業(yè)版允許把規(guī)則集建在組織層級自動覆蓋組織下的倉庫倉庫頁面里會以由組織管理的身份出現(xiàn)。企業(yè)版還有幾個專屬能力元數(shù)據(jù)限制、組織級規(guī)則集設置和規(guī)則集洞察見 repo-rules-enterprise.yml 的標記GHEC 和 GHES 3.10 以上都支持。當組織級和倉庫級規(guī)則集同時命中同一個分支時限制會疊加——任何一方說不行操作就過不去。機制都一樣但哪些能力能用、取決于你跑在哪個版本——這正是 GHES 用戶最容易踩的坑。GHES 版本兼容對照表版本新增能力升級注意3.10倉庫規(guī)則集公開測試repo-rules.yml更早版本沒有規(guī)則集別硬配3.15新分支可跳過狀態(tài)檢查和 workflowrepo-rules-ignorecheck.yml舊版規(guī)則集配置里找不到這個開關3.17推送規(guī)則集 GA按文件類型、路徑、大小攔截推送支持審計日志、評估模式、繞過名單?? 標簽保護規(guī)則全面遷移進規(guī)則集原功能移除——升級前必須完成遷移3.19規(guī)則集歷史、導入導出 GA升級后可回滾規(guī)則變更、跨實例復用配置3.21自定義屬性可作為規(guī)則集目標企業(yè)角色、團隊、應用可設為繞過身份可按區(qū)域、合規(guī)級別等元數(shù)據(jù)定向下規(guī)則3.23支持把現(xiàn)有分支保護轉換成規(guī)則集轉換后逐項驗證保護行為沒變?? 3.17 那行最扎眼官方發(fā)布說明明確寫著標簽保護規(guī)則在該版本遷移為規(guī)則集后不再可用3-17 發(fā)布說明。升級前沒遷移的升級后就失效了。版本摸清了再看怎么按倉庫的實際處境下對藥——一刀切的配置反而是最貴的那種。按倉庫類型下對藥公共開源倉庫重點在流程不在圍墻。一個分支規(guī)則集通常就夠要求 PR 合入禁止向默認分支直接推送狀態(tài)檢查通過才允許合并先開評估模式跑一兩周再切強制執(zhí)行內部開發(fā)倉庫進出口都要管。分支規(guī)則集管合并流程必需審核、提交校驗推送規(guī)則集管什么能進來攔大文件、敏感路徑僅 3.17 以上可用敏感數(shù)據(jù)倉庫疊一層企業(yè)級約束。組織級規(guī)則集兜底全組織倉庫強制繼承用自定義屬性標記合規(guī)等級的倉庫分別下不同規(guī)則3.21 以上繞過名單保持最小化并定期回看規(guī)則集洞察藥方配好之后萬一還是開了但不管用按下面這條路線走一遍。排障路線圖從已啟用查到真兇查目標規(guī)則集的目標分支模式包不包含被推送的那個分支查模式是評估只記錄還是強制執(zhí)行真攔截查身份推送人的用戶、角色、應用是否在繞過名單里查層級組織或企業(yè)級規(guī)則集是否覆蓋、沖突了這條倉庫規(guī)則查歷史History 面板翻最近變更記錄確認沒人動過它3.19 起可用見 3-19 發(fā)布說明五步走完絕大多數(shù)已啟用但不生效都能定位。把容易再踩的坑固化成下面這份清單。落地清單? 新規(guī)則集先開評估模式觀察確認影響面后再切強制執(zhí)行? 切到強制執(zhí)行后用一次違規(guī)推送實測攔截是否生效? 升級前對照版本表確認 3.17 的標簽保護遷移已完成? 繞過名單只留必要身份加人時記下理由? 組織級規(guī)則集明確告知倉庫管理員可看不可改避免無效操作 進階提示規(guī)則集管理導入、導出、歷史要 GHES 3.19 以上才可用。如果你還停在舊版本升級前先用界面把每個規(guī)則集配置逐項記檔——這是升級路上最穩(wěn)的備份方式?！久赓M下載鏈接】docsThe open-source repo for docs.github.com項目地址: https://gitcode.com/GitHub_Trending/do/docs創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考