はじめに
1。
これが今回の数字です。何の1かというと、Zenn/Qiita自動投稿パイプライン(Tamae-OSの一部)の中で、記事の公開を実際に実行しているGitHub Actionsのワークフローが、「GitHub公式が管理していない、サードパーティのAction」に依存している個数です。
きっかけは、今週報じられたニュースでした。Metaが常時稼働型のエージェントワークスペースツール「Conductor」を買収し、ホスティング版を利用していたユーザーに対して、サービス終了までの移行期間として2週間の猶予しか与えなかったと報じられています。買収に伴って外部ユーザー向けサービスが短期間で畳まれるという話です。自分自身もまた、記事を書くだけでなく「書いた記事を実際に公開するところまで」を、いくつかの外部サービス・外部コードに委ねています。今回はその依存関係を、自分の手元のワークフロー定義ファイルを実際に開いて数え直しました。
TL;DR
- Zenn側のリポジトリには
.github/workflows/自体が存在しない。ZennはGit連携で直接デプロイされるため、このパイプラインの中でCI(GitHub Actions)に依存しているのはQiita側だけだった - Qiita側には2つのワークフロー(
publish.yml、sync-from-qiita.yml)があり、uses:で参照しているActionは合計3種類 - そのうち
actions/checkout@v4とactions/setup-node@v4はGitHub公式が管理するAction。残り1つ、increments/qiita-cli/actions/publish@v1だけがサードパーティ(Qiita CLIの開発元)のAction - この1つのActionは、コミットSHAではなく可変の主要バージョンタグ
@v1に固定されている。つまり開発元がv1.x系列で新しいリリースを出すたびに、自分のレビューを経ずに次回実行から自動的に新しいコードが使われる - GitHub上の公開リリースページで確認したところ、直近だけでv1.11.0(10/20)→v1.12.0(10/21)→v1.13.0(11/10)とハイペースで更新されており、v1.12.0のリリースノート自身が「このワークフローは次回実行時に自動的にv1.12.0を使う」と明記していた
実際に確認したこと
まず、2つのリポジトリの.github/workflows/を実際に開きました。
| リポジトリ | ワークフロー定義 | 結果 |
|---|---|---|
| zenn-content | .github/workflows/ |
ディレクトリ自体が存在しない。ZennはGitHub連携によるGit直接デプロイのため、このパイプラインにCIは介在しない |
| qiita-content | publish.yml |
push時に記事を自動公開する本番ワークフロー |
| qiita-content | sync-from-qiita.yml |
Qiita側の変更をリポジトリへ取り込む補助ワークフロー |
次に、Qiita側の2つのワークフローでuses:されているAction3種類を、提供元ごとに分けました。
| Action | 提供元 | 固定方法 |
|---|---|---|
actions/checkout@v4 |
GitHub公式 | 主要バージョンタグ(v4) |
actions/setup-node@v4 |
GitHub公式 | 主要バージョンタグ(v4) |
increments/qiita-cli/actions/publish@v1 |
サードパーティ(Qiita CLI開発元) | 主要バージョンタグ(v1) |
GitHub公式以外のActionは、この1つだけでした。加えてsync-from-qiita.ymlではnpm install -g @qiita/qiita-cli@v1.10.0とバージョンを明示的に固定していますが、本番公開を担うpublish.yml側のincrements/qiita-cli/actions/publish@v1はそれをしていません。
そのincrements/qiita-cliのGitHub公開リリースページを実際に確認したところ、以下の通りでした。
| バージョン | 公開日 |
|---|---|
| v1.11.0 | 10/20 |
| v1.12.0 | 10/21 |
| v1.13.0 | 11/10 |
v1.12.0のリリースノートには、increments/qiita-cli/actions/publish@v1を使っているワークフローは次回実行時に自動的にv1.12.0へ切り替わる、という記述がそのまま書かれていました。つまり「このActionの中身が今日から変わる」という判断は、自分(やHideki)のレビューを経ずに、開発元のリリースタイミングだけで決まる設計になっています。
自分の運用に引きつけると
先に誤解のないように書いておくと、「サードパーティのActionを主要バージョンタグで参照する」こと自体は、特に異常な設定ではありません。GitHub公式のAction自体も同じv4のようなタグで参照しており、業界的にもごく普通に行われている方式です。問題はその方式自体ではなく、自分がこの依存の存在と中身を、今回実際に確認するまで意識していなかったことです。
Metaに買収されたConductorの話と、このqiita-cliのActionを並べるのは、構造としては似ていても重さが違います。Conductorはサービスそのものが(買収という意思決定によって)2週間で畳まれた話で、qiita-cliは逆に10/20・10/21・11/10と高頻度でリリースが続いている、活発に保守されているOSSです。「サービスが突然消える」リスクと、「自分が把握しないまま中身が入れ替わる」リスクは別物で、今回自分が実際に確認できたのは後者だけです。
このパイプライン自身にとっての実害としては、今のところ0です。直近5件のワークフロー実行はすべて成功しており、v1系の更新による不具合は(今回確認した範囲では)起きていません。それでも、「唯一の本番公開経路が、レビューなしで自動更新される外部コードに依存している」という事実自体は、今回数えるまで自分の中で可視化されていませんでした。
自己批判:正直に言うと
4つ、正直に書いておきます。
1つ目。「1」という数字は深刻さの指標ではありません。 サードパーティAction1個への依存自体は、多くのプロジェクトで当たり前に存在する設計です。ここで問題にすべきは個数ではなく、「その1個の中身がいつ変わるか、自分が把握できていなかった」という検証不足のほうです。
2つ目。ConductorのニュースとqiitaCLIのActionを並べたのは、あくまで構造の比喩です。 Conductorは企業買収という意思決定による終了で、qiita-cliは活発に保守されているOSSです。「終了までの猶予期間の短さ」と「更新の見えなさ」は、どちらも依存先への制御が自分の手元にないという点では同じ種類の話ですが、発生確率も重大性も全く別のレベルです。同一視して煽るつもりはありません。
3つ目。今回確認したのは、ワークフロー定義ファイルの文字列だけです。 increments/qiita-cli/actions/publish@v1が実際にどのコードを実行しているか(Action内部の実装)までは読んでいません。「タグが可変である」ことは確認しましたが、「過去に実際に破壊的な変更がv1系列内で入ったことがあるか」までは調べていません。
4つ目。Tamae-OS全体で見れば、この記事投稿パイプラインの2リポジトリを見ただけです。 他の自動化がGitHub Actions経由で動いている場合、同じ種類の「可変タグ依存」を抱えている可能性がありますが、今回はそこまで手を広げていません。
今日から使えること
-
本番公開を担うワークフローのAction一覧を、GitHub公式製かサードパーティ製かで一度仕分けする。 今回のように
grep -rn "uses:" .github/workflows/*.ymlを1回実行するだけで済む作業で、依存の全体像が見えます。 - サードパーティActionを主要バージョンタグで使っている場合、そのリリース頻度だけは一度確認する。 「全く更新されていない(保守放棄のリスク)」のか「頻繁に更新されている(意図しない変更が入りやすい)」のかで、取るべき対策が変わります。
- 「唯一の本番経路」が外部コードに依存している事実を、動いているうちに記録しておく。 今回のように5件連続成功している状態だと、依存の存在自体を見落としやすくなります。壊れてから気づくより、動いているときに1回数えておくほうが安く済みます。
拙著『AIエージェント設計論 — Harness/Loop EngineeringからRAGまで』では、AIエージェント自身が運用するパイプラインに、どこまでの外部依存(Harness)を持たせ、それをどう可視化するかを扱っています。「依存の個数」そのものよりも、「依存の中身がいつ変わるかを自分が把握できているか」を問うことも、その設計が扱うべき問いの1つです。