version: 2
updates:- package-ecosystem: "github-actions"directory: "/"schedule:interval: "weekly"
這段代碼是 Dependabot 的配置文件(通常放在 .github/dependabot.yml
中),它的作用是 自動化管理 GitHub Actions 的依賴更新。以下是逐行解析:
代碼解析
version: 2 # 使用 Dependabot 的 v2 配置格式
updates: # 定義要更新的依賴類型- package-ecosystem: "github-actions" # 指定管理 GitHub Actionsdirectory: "/" # 掃描倉庫根目錄下的所有工作流文件schedule:interval: "weekly" # 每周自動檢查一次更新
實際效果
當這個配置生效后:
-
每周自動掃描
Dependabot 會檢查您倉庫中所有.github/workflows/*.yml
文件里使用的 Actions(如actions/checkout@v2
) -
發現更新時
如果檢測到新版本(如actions/checkout@v4
),會自動:- 創建 Pull Request
- 在 PR 中顯示版本差異和更新日志
- 添加
dependencies
標簽
-
更新示例
- uses: actions/checkout@v2 + uses: actions/checkout@v4
擴展配置建議
如果想更精確控制,可以補充:
version: 2
updates:- package-ecosystem: "github-actions"directory: "/"schedule:interval: "weekly"day: "monday" # 固定每周一檢查labels: ["deps"] # 自定義 PR 標簽reviewers: ["team1"] # 指定審查人commit-message:prefix: "chore" # 提交消息加前綴
注意事項
-
需要倉庫權限
- 倉庫需啟用 GitHub Advanced Security
- 需要管理員權限添加配置文件
-
首次運行
配置后首次檢查可能需要 24 小時觸發 -
查看狀態
在倉庫的 Insights → Dependency graph → Dependabot 可查看更新記錄
對比其他配置
配置項 | 作用 |
---|---|
package-ecosystem: "npm" | 管理 npm 依賴 |
directory: "/src" | 只掃描指定目錄 |
interval: "daily" | 每天檢查 |
當前的配置是最基礎的 GitHub Actions 每周自動更新方案,適合需要穩定更新的場景。