GitHub Actions#

北米版 BD 販売予定リスト#

せっかくなので成果物は先に載せておきます。

定期実行#

GitHub Actions は様々なトリガーに対して Action を起こすことができます。たとえばコミットがプッシュされたときや、タグが付けられたときなどがあります。

GitHub Actions は Cron を利用して定期実行されます。

::: tip GitHub Actions の定期実行

Cron は本来は一分単位で実行が可能なのだが、GitHub Actions では最短五分あけないと実行されないようになっている。

負荷がかかるので当然だが、逆に言えば五分に一回実行できるのはありがたい。

:::

name: Scheduled build # 名前は必須

on:
  schedule:
    - cron: "0 0 * * *" # 定期実行のコマンド

┌───────────── minute (0 - 59)
│ ┌───────────── hour (0 - 23)
│ │ ┌───────────── day of the month (1 - 31)
│ │ │ ┌───────────── month (1 - 12 or JAN-DEC)
│ │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
* * * * *

0 0 * * *   # 毎日00:00(UTC)に実行

0 * * * *   # 毎時0分に実行

30 * * * *  # 毎時30分に実行

*/10 * * * *  # 10分置きに実行 -> 00, 10, 20, ... , 55

* */1 * * *   # 1時間置きに実行

05-59/10 * * * *  # 10分置きに実行 -> 05, 10, 15, 20, ... ,55

YML を記述しよう#

今回は以前の記事で紹介した RightStuf から北米版 BD の販売情報を取得するプログラムを考えます。

あれは Python で動作するので、GitHub Actions でも Python を実行する環境を与えます。

jobs:
  build:
    name: build
    runs-on: ubuntu-latest # Ubuntuを使えば基本的には問題ない
    steps:
      - uses: actions/checkout@v2 # おまじない

      - name: Setup Python # Pythonのセットアップ
        uses: actions/setup-python@v2
        with:
          python-version: "3.9" # Pythonのバージョン指定

      - name: Install dependencies # 依存パッケージのインストール
        run: |
          python -m pip install --upgrade pip
          pip install requests

      - name: Run right.py # PythonでRigthStufからデータ取得
        run: |
          python right.py

      - name: Commit and Push # 実行結果をプッシュしてレポジトリに反映
        run: |
          git config --local user.email "XXXXXXXXXXXX" # メールアドレスを設定 
          git config --local user.name "XXXXXX" # ユーザ名を設定
          git add .
          git commit -m "ZZZZZZZZZZ" # コミットメッセージを記述
          git pull
          git push origin master

これがテンプレートで Python を実行したいのであればこの書き方で問題ありません。

こうしておけば、一日一回実行され、そのときにright.pyが新しいファイルを作成してその内容が自動的にプッシュされ、プッシュされることで Netlify の自動ビルドが始まるという仕組みです。

::: warning GitHub のプッシュについて

今回の例でいうとpython right.pyのコマンドで新規ファイルまたはファイルに変更がないとgit commitのときに「変更点がないよ」と怒られてしまう。

何らかの差分が生じるようなコードにしよう。

:::