このビルドワークフローは、self-hosted Docker アプリ定義を Homelab や NAS OS で配布できる再利用可能な成果物へ変換します。
このページでは、成果物ビルドワークフロー .github/workflows/release.yml を説明します。
目的
リポジトリのソース定義を、再利用可能なビルド成果物へ変換します。
トリガー
mainへの push- 手動の
workflow_dispatch
主な段階
- リポジトリのソースをチェックアウトします。
- ビルドキャッシュを復元します。
- v2 プロトコルの
dist/をビルドします。 - 従来の v1 zip 出力をビルドします。
- ビルドレポートと配布用成果物をアップロードします。
- ビルドキャッシュを保存します。
- job summary を書き込みます。
ビルド出力
現在、このワークフローは少なくとも次を生成します。
- v2 プロトコル用の静的
dist/出力 - 従来の
dist/store/main.zip - v1 と v2 のビルド結果を示す JSON レポート
重要な理由
このワークフローは、リポジトリのビルド契約を示します。
- ソースファイル自体が公開プロトコルになるわけではありません
- 公開成果物は
dist/です - アップロードされたレポートはデバッグ成果物であり、プロトコルファイルではありません
関連する公開ワークフロー
タグに基づく実際の公開は、公開ワークフローで行います。
サードパーティストアのリポジトリを設計する場合は、推奨される再利用方法を公式アクションの再利用で確認してください。
公式ワークフローを完全にコピーしない外部ストアの管理者にとっても、このページは、プロトコルに不可欠な手順と実装上の詳細を区別する参考になります。