毎週自動で動かす｜GitHub Actions の決まった時刻と、手で動かすボタン

GitHub Actions で、決まった時刻に動かす

GitHub Actions は、GitHub の上で、決まった時刻やボタンを押したときに手順を動かすしくみです。手順は、リポジトリの .github/workflows/ に置く YAML のファイルに書きます。

いちばん上の「いつ動くか（on）」に、schedule（決まった時刻）と workflow_dispatch（手で動かすボタン）を書きます。時刻は cron という形で、「分 時 日 月 曜日」の5つを空白で区切って書きます。

公式によると、混んでいるときは schedule が遅れることがあり、とても混んだときは動かないこともあります。毎時0分ちょうどは特に混みやすいので、分をずらすようすすめています。上の例で「17分」にしているのはそのためです。動かなかった週は、あとで「Run workflow」で手で動かします。schedule が動くのは、既定のブランチ（ふつうは main）に置いたファイルだけです。

時刻は、はじめの設定では UTC です。公式によると、タイムゾーンを指定して、日本時間で書くこともできます。UTC に直すのがむずかしければ、依頼文に「日本時間の月曜 6:17 で、タイムゾーンを指定して書いて」と頼んでもかまいません。

APIキーは Secrets に入れる

ワークフローで Claude API を使うには APIキーが要ります。キーはファイルに書かず、リポジトリの Secrets に入れます。Settings → Secrets and variables → Actions →「New repository secret」で、名前と値を入れます。

キーをこの用途専用に分けておくと、漏れたときに止めるのも、使った量を見分けるのもかんたんです。もう使わなくなったら、Secrets から消すだけでなく、Console でキーも削除します。

中身は Claude Code に書いてもらう

ワークフローの中でやることは、先週の CSV があるかを確かめてから、これまでのレッスンで作った3つのプログラムを順に動かして、できたファイルをリポジトリに保存（コミットして push）することです。この中身も、Claude Code に書いてもらいます（下の「やってみよう」の依頼文）。

コミットするのは、下書きの md だけではありません。順位の JSON（data/ranking/）と紹介文の JSON（data/draft/）も入れます。ワークフローは毎回まっさらな場所で動くので、push しなかったファイルは、次に動く公開のワークフロー（レッスン10）からは見えないからです。

同じコミットを preview というブランチにも push すると、Cloudflare Pages がそのブランチ用の確認用のページを作ります。レッスン8の作りで、このページにだけ下書きが出ます。

できたら GitHub の Actions の画面で「Run workflow」を押し、手で1回動かして確かめます。公開リポジトリでは、60日間リポジトリに動きがないと schedule のワークフローが自動で止まります。止まっていたら、同じ画面の「Enable workflow」で戻します。

サイトの作り直しを確かめる

Cloudflare Pages を GitHub とつないでいれば、ふつうは push で自動で作り直されます。ただし公式によると、ワークフローの中の標準の鍵（GITHUB_TOKEN）で push したときは、ほかのワークフローは動きません。Cloudflare Pages がどう反応するかは公式に書かれていないので、はじめて動かしたら、Cloudflare のデプロイの一覧で作り直されたかを確かめましょう。

やってみよう

1. Claude Console で、この自動のしくみ専用の APIキーを作ります（レッスン2。名前は cat-ranking-weekly など）
2. GitHub のリポジトリの Settings → Secrets and variables → Actions → New repository secret で、名前 ANTHROPIC_API_KEY にキーを入れます
3. 下の依頼文を Claude Code に送って、ワークフローのファイルを作ってもらいます
4. 先週の CSV（レッスン6）が data/views/ に push されていることを確かめます（レッスン6の見本の CSV で練習するときは、ファイル名を先週の月曜の日付に変えてから push します。日付が先週でないと、ワークフローは止まります）
5. push したら、GitHub の Actions の画面で、そのワークフローの「Run workflow」を押して、手で1回動かします
6. 下書きのファイルができたこと、Cloudflare Pages のデプロイの一覧で main と preview の2つが作り直されたことを確かめます

確認問題