このページでは、mad-action GitHub Actionとコンテナイメージがこのリポジトリから公開される仕組み、およびサテライトを最新に保つルールを説明します。
サテライトとは、mthomason/MADの外にあるリポジトリで、MADから構築された何かを公開するものです。今日ではmad-action GitHub Actionが、GHCR上のコンテナイメージと並んで該当します。サテライトは公開ターゲットであり、フォークではありません。MADが真実の源であり、サテライトはここのディレクトリから生成され、境界を越えるのは公開成果物とsatellites/<name>/の下のファイルだけです。
これはイメージと同じモデルです。Linux/がソースで、.github/workflows/publish-image.ymlがmasterへのプッシュごとにghcr.io/mthomason/madを公開し、エンジンのソースをどこか別の場所にコピーするものはありません。アクションのユーザーが新しいエンジンを得るのは、サテライトリポジトリがコミットを受け取ったからではなく、イメージタグが動いたからです。
| サテライト | ソース | 公開元 | 参照 | バージョンタグ |
|---|---|---|---|---|
| mthomason/mad-action | satellites/mad-action/ |
.github/workflows/publish-mad-action.yml |
ghcr.io/mthomason/mad:latest |
v1(移動中。satellites/mad-action/VERSION) |
ghcr.io/mthomason/mad(イメージ、リポジトリではない) |
Linux/ |
.github/workflows/publish-image.yml |
— | latest、<short-sha> |
mthomason/mad-actionは生成されます。直接編集しないでください。変更はここのsatellites/mad-action/に行い、通常のPRゲートを通し、公開ワークフローがそれを運びます。アクションのイシューとプルリクエストはmthomason/MADに属します。
| MADでの変更 | サテライトの更新 |
|---|---|
| エンジンまたはアプリのコード | なし——次のmasterプッシュが:latestを再公開し、アクションがそれを実行する |
| ドキュメント | なし——アクションのREADMEがMADにリンクする |
| CLIの動詞、フラグ、認証情報入力、またはエクスポートフォーマット | satellites/mad-action/action.yml、入力マッピングやドキュメントが変わる場合はREADME.md |
| イメージ名またはタグポリシー | satellites/mad-action/action.yml、README.md、ワークフロー |
CLI/Fixtures/London.portable.mad |
自動: 公開ワークフローがfixtures/へコピーする |
LICENSEまたはNOTICE |
自動: 公開ワークフローが両方をコピーする |
satellites/mad-action/** |
自動: 公開ワークフローがディレクトリを同期する |
公開ワークフローは、これらのパスのいずれかが変わるとmasterで実行され、workflow_dispatchで手動でも実行できます。公開イメージに対してソースをテストし、ターゲットを同期し、MAD release botとしてコミットし、メジャータグを動かし、プッシュ時にターゲット自身のテストワークフローを走らせます。サテライトのテストワークフローは毎日スケジュールもされます——ラッパーのソースが変わっていなくてもエンジンの変更がラッパーを壊したときに捕捉するカナリアです。
GitHubはリポジトリの活動が60日ないとスケジュールされたワークフローを無効にします。次の同期コミットがそれを再有効化し、その間は手動のworkflow_dispatchがテストを直ちに実行します。これがこの取り決めで、失敗せずに静かになり得る唯一の部分です。
通常のソース変更。
satellites/mad-action/および/またはフィクスチャを編集します。./Linux/build.sh --verifyがmad-cli:latestをビルドし、アクションはimage: mad-cli:latestでそれを指せます)。Linux verificationがPR自身のランタイムイメージに対してラッパーを実行し(linux.yml)、ターゲットでのアクションのテストに加えます。Publish mad-actionがテストして公開し、ターゲットリポジトリでのサテライト自身のテスト実行がその後グリーンでなければなりません。CLI契約の変更。 同じPRがaction.ymlの入力とREADMEを更新します。公開はv1を動かし、既存ユーザーは次回実行時に新しいラッパーを得ます。変更が破壊的——入力の名前変更や削除、デフォルトの非互換な変更——の場合は、同じPRでsatellites/mad-action/VERSIONをv2に上げ、READMEの@v1参照を更新します。ワークフローはv2を動かし、v1をそのまま残すため、mthomason/mad-action@v1のユーザーは移行するまで古いメジャーを保ちます。
フィクスチャのリフレッシュ。 MADでフィクスチャを再生成し(CLI/Fixtures/README.md)、パスフィルタがそれをコピーします。サテライトリポジトリのコピーを編集しないでください。
デプロイキーのローテーション。 新しいed25519キーを生成し、その公開半分を書き込みデプロイキーとしてmthomason/mad-actionに追加し、秘密半分をmthomason/MADのMAD_ACTION_DEPLOY_KEYシークレットとして設定し、Publish mad-actionをディスパッチし、その後古いデプロイキーを削除します。キーは1つのターゲットリポジトリにスコープされ、書き込みしかできません。
ターゲットリポジトリは空で公開として作成されました。GitHubのデフォルトブランチはmainで、最初の公開がそれを埋めます。ワークフローはmainにプッシュします。最初の同期がREADMEとライセンスの両方を供給するため、READMEやライセンスで初期化されませんでした。イシューとWikiはそこで無効です。READMEが両方をMADへ送ります。もし再作成されることがあれば、これを繰り返してください。
gh repo create mthomason/mad-action --publicMAD publish workflowというタイトルの書き込みデプロイキーを追加する。mthomason/MADのMAD_ACTION_DEPLOY_KEYシークレットとして設定する。Publish mad-actionをディスパッチする。サテライトは独自のサードパーティ依存を持ちません。その本体は公開イメージのdocker runであり、ライセンスファイルはMADのもの(LICENSE、NOTICE)です。
ここのsatellites/<name>/を作成し、publish-mad-action.ymlの形で公開ワークフローを追加し、上のレジスタ行を追加します。ルールは同じです。MADが真実の源であり、サテライトは公開成果物を消費し、バージョンファイル(または同等物)がユーザーがピン留めする移動タグを名指しします。エンジンのソースをサテライトにミラーしないでください。それはすでにイメージの中で旅をします。
このページは英語原文の日本語翻訳です。内容に相違がある場合は、英語原文が優先されます。