github-workflows

GitHub ワークフロー

Rust プロジェクト向けに GitHub Actions ワークフローの診断、修正、最適化を行います。

クイックリファレンス

• キャッシュ戦略 - 手動キャッシュ、rust-cache、sccache
• トラブルシューティング - よくある問題、デバッグ、修正
• 高度な機能 - カバレッジ、セキュリティ、ベンチマーク
• リリース管理 - リリースの自動化、バージョン管理

使用する場面

• Rust プロジェクトの CI/CD を設定するとき
• ワークフローの失敗をトラブルシューティングするとき
• キャッシュを使ってビルド時間を最適化するとき
• テスト、リンティング、リリースのベストプラクティスを徹底するとき

変更を加える前に

必ず最初に現在の状態を確認してください：

# Get repo info
gh repo view --json nameWithOwner,owner,name

# List existing workflows
gh workflow list

# Check recent runs
gh run list --limit 10

# View workflow files
ls -la .github/workflows/

Rust CI ワークフロー全体

次の内容を含む完全なワークフローテンプレートを参照してください：

• チェックジョブ（フォーマット、clippy、check）
• テストジョブ（ユニットテスト、統合テスト、ドキュメントテスト）
• カバレッジジョブ（tarpaulin、codecov）
• 監査ジョブ（セキュリティ、ライセンス）

キャッシュ戦略、トラブルシューティング、リリース管理については、リンク先のファイルを参照してください。

ワークフローの主要コンポーネント

ジョブ	目的	ツール
check	コード品質	rustfmt、clippy、cargo check
test	検証	cargo test
coverage	テスト指標	cargo tarpaulin
audit	セキュリティ	cargo audit、deny

よくあるパターン

• キャッシュ：依存関係、target ディレクトリ、sccache
• マトリックスビルド：複数の Rust バージョン、ターゲット
• 条件付きジョブ：ドキュメントのみの変更ではスキップ
• 品質ゲート：失敗時にマージをブロック

PR チェック紐付けのガードレール

• 修正をプッシュした後、チェックが PR の head SHA に紐付いていることを検証します：
  • gh pr view --json statusCheckRollup,mergeStateStatus
  • gh run list --commit <head_sha>
• 必須チェックのロールアップが空の場合は、ブロックされているものとして扱い、トリガーやパスの条件を調査してください。