GitHub PagesのActionsビルドが失敗した時の確認ポイント
GitHub Pagesの公開でActionsが失敗した時は、workflowだけでなく、公開方法、branch、build対象ディレクトリ、index.html、assets、権限、直前の差分を分けて確認します。
このページでわかること
- Pagesの公開方法とActionsログを見る
- build対象と成果物を確認する
- 直前の差分や権限変更を確認する
まず確認すること
- Pages設定とworkflowの関係を見る
- index.html、CSS、画像パスを確認する
- artifactやdeploy先に不要ファイルがないか見る
やってはいけないこと
- Actionsを消せば直ると考える
- 公開成功を保証する
- Secretsを含む成果物を扱う
安全寄りに進める手順
- 対象のrepo、branch、PR、Actions runを確認する。
- Secrets、APIキー、token、.env、個人情報が差分やログに出ていないか見る。
- 必要な場合は値を停止または再発行し、影響範囲を整理する。
- 変更は小さなbranchとPRに分け、CIとreviewで確認する。
CodexやAI作業時の注意
AIに作業を渡す時は、対象ファイル、触らないファイル、確認項目を明記します。認証情報や実際のキー値は本文、Issue、PR説明、ログ、レポートに残さないようにします。
公式情報で確認する領域
Actions、Secrets、PR、repository visibility、workflow permissionsは仕様が変わることがあります。実作業前にはGitHub Docsで最新の説明を確認してください。