2.2テンプレートと再利用 — スターター・再利用可能ワークフロー・コンポジット

同じパイプラインを何度も書かないために、GitHub には複数の 再利用の仕組み があり、GH-200 ではそれぞれの違いと使い分けが問われます。最もよく混同されるのが、スターターワークフロー・再利用可能ワークフロー・コンポジットアクション の 3 つです。要点は「コピーして独立するのか、中央定義を呼ぶのか、ステップをアクションに束ねるのか」という違いにあります。

2.2.13 つの再利用方法の違い

スターターワークフロー（starter workflow） は、新しいワークフローを作るときの 雛形（テンプレート） です。組織の .github リポジトリに置くと、メンバーが「新しいワークフロー」画面から選んでコピーできます。コピー後は 独立 し、元を変えても各リポジトリには波及しません（最初の足場用）。一方 再利用可能ワークフロー（reusable workflow） は on: workflow_call を持つ 中央の定義 で、呼び出し側が uses: で参照します。元を更新すれば（参照する ref により）呼び出し側に反映され、バージョン管理された一元定義 として機能します。コンポジットアクション（composite action） は、複数のステップを 1 つの アクション にまとめたもので、ワークフローの 1 ステップ（uses:）として呼び出します。

2.2.2組織レベル・非公開テンプレートの消費

組織は、スターターワークフローと再利用可能ワークフローを 組織内（非公開） で共有できます。スターターワークフローは組織の .github リポジトリ の workflow-templates に置き、メンバーが選んで使います。再利用可能ワークフローは、組織内のプライベートリポジトリ にあるものを他リポジトリから呼び出せるよう アクセス（共有）設定 を有効にして消費します。これにより、公開せずに社内標準のパイプラインを配布・統制できます。

2.2.3ワークフローの無効化と削除

ワークフローを止めたいとき、無効化（disable） と 削除（delete） は意味が異なります。無効化は、ワークフローファイルを残したまま 一時的に実行を止める もので、UI から再度 有効化 できます（メンテナンスや一時停止に好適）。削除はファイル/履歴に対する破壊的操作で、元に戻すには再作成が必要です。「しばらく動かしたくないだけ」なら無効化、「もう不要」なら削除、と使い分けます。

2.2.4この節のまとめ

• スターターワークフロー＝新規作成の雛形（コピー後独立）、組織の .github リポジトリで配布
• 再利用可能ワークフロー＝on: workflow_call の中央定義を uses: で呼ぶ（波及・バージョン管理）
• コンポジットアクション＝複数ステップを束ねたアクション（1 ステップとして利用）
• 非公開共有はアクセス設定が必要。一時停止は無効化（再有効化可）、不要なら削除