ビルドアーティファクトのアップロードとダウンロード
GitHub Actionsアーティファクトを使用してジョブ間でファイルを共有。ビルド出力、テストレポート、カバレッジデータのアップロードと依存ジョブでのダウンロードを解説。
Advanced
詳細な説明
GitHub Actionsのビルドアーティファクト
アーティファクトはワークフロー実行からファイルを永続化します — ビルド出力、テストレポート、ログ、カバレッジデータなど — ジョブ間で共有したり、ワークフロー完了後にダウンロードしたりできます。
主要機能
| 機能 | 説明 |
|---|---|
retention-days |
アーティファクトの保持期間(1-90日、デフォルト90) |
if: always() |
前のステップが失敗してもアップロード(テストレポートに最適) |
compression-level |
0-9、0は圧縮なし(デフォルト6) |
アーティファクト vs キャッシュ
| アーティファクト | キャッシュ | |
|---|---|---|
| 目的 | 出力の共有、結果のダウンロード | 依存関係インストールの高速化 |
| 有効期間 | 設定可能な保持期間(1-90日) | アクセスなしで7日後に削除 |
| 可視性 | ワークフロー実行UIに表示 | 非表示、自動 |
| ジョブ間 | はい(download-artifact経由) | いいえ(同じジョブのみ) |
ユースケース
CIとデプロイジョブ間でのビルド出力の共有、失敗した実行のデバッグ用テストレポートの保存、並列テストジョブからのカバレッジデータの収集、またはダウンロード用リリースバイナリのアーカイブ。