用途
在發布前掃描儲存庫中的 CNAME 文件。遺留的 CNAME 文件會默默將 GitHub Pages
指向你可能無法控制的網域。此技能會找到它並阻止發布。
先決條件
- 需在
PATH環境變數中包含bash和find
驗證環境
在執行任何操作之前,請執行:
command -v find && command -v bash
如果其中任一命令缺失,請停止並回報:MISSING_DEP: find。
逐步操作
-
從儲存庫根目錄執行檢查:
bash scripts/check-cname.sh -
如果腳本返回非零退出碼,請回報
FORBIDDEN: CNAME file present並停止 發布。不要悄悄刪除該文件 — 應將路徑顯示給使用者。 -
如果腳本返回零退出碼,請回報
OK: no CNAME file。
切勿假設
- 切勿假設刪除
CNAME文件就能清除託管提供商儲存的自訂網域設定。 該文件與帳戶設定是分開的。回報文件即可;不要聲稱網域已取消設定。 - 切勿假設沒有
CNAME文件的儲存庫就是安全的 — 應另外檢查託管提供商 儲存的網域設定。 - 切勿自動刪除
CNAME文件。回報它,讓擁有者自行決定。
輸出
一行文字:OK: no CNAME file 或 FORBIDDEN: CNAME file present at <路徑>。
失敗處理
find缺失 → 回報MISSING_DEP: find,停止。- 發現
CNAME文件 → 返回非零退出碼,列印其路徑,停止發布。