GitHub ActionsでPlaywrightを毎日実行する方法｜スケジュール実行（cron）で本番監視・回帰テストを自動化する

GitHub Actions で Playwright を動かす記事の多くは「コードをpushしたら実行する」push/pull_requestトリガーを扱いますが、実務では「毎日決まった時間に本番環境の健全性をチェックしたい」「夜間に回帰テストを流しておきたい」というニーズも少なくありません。この記事では、GitHub Actionsのschedule（cron）トリガーを使ってPlaywrightを毎日自動実行する方法を、通知設定・本番テストの注意点も含めて解説します。

push/PRトリガーとschedule（毎日実行）トリガーは、似ているようで運用の考え方が異なります。無人で実行される前提だからこそ気をつけるべきポイントがあります。

push/PRトリガーのCIは「コード変更を検証する」ことが目的ですが、毎日実行するスケジュール型のテストは目的が異なります。

• コードは変わっていなくても、外部APIやインフラ側の変化で本番環境が壊れていないかを確認したい
• 夜間などトラフィックが少ない時間帯に、時間のかかる回帰テストを流したい
• 誰もPRを見ていない時間帯に失敗しても、後から気づけるようにしたい

この記事では、こうしたニーズに対応するための実装ポイントを順番に解説します。

① schedule（cron）トリガーの基本

GitHub Actionsでは、on.scheduleにcron構文を指定することで、決まった時刻にワークフローを自動実行できます。

# .github/workflows/daily-playwright.yml
name: Daily Playwright Tests

on:
  schedule:
    - cron: "0 0 * * *"  # 毎日 UTC 0:00 = JST 9:00 に実行

jobs:
  test:
    timeout-minutes: 30
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.12"

      - name: Install dependencies
        run: |
          pip install -r requirements.txt --break-system-packages
          playwright install --with-deps

      - name: Run Playwright tests
        run: pytest tests/ --alluredir=allure-results

      - name: Upload results
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: allure-results
          path: allure-results/

② workflow_dispatch を併用して手動実行も可能にする

スケジュール実行だけでは、「今すぐ結果を確認したい」というときに次の実行時刻まで待つ必要があります。workflow_dispatchを併用すると、GitHubのUIから手動でも同じワークフローを実行できるようになります。

on:
  schedule:
    - cron: "0 0 * * *"
  workflow_dispatch:  # ← 手動実行ボタンが追加される

③ 失敗時にSlack通知を送る

毎日実行されるテストは、push/PRトリガーと違って**誰も結果を見に行かない**ことが多いです。失敗した場合に自動で通知される仕組みがないと、定期実行の意味が薄れてしまいます。

jobs:
  test:
    timeout-minutes: 30
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      # ... セットアップ・テスト実行ステップ ...

      - name: Run Playwright tests
        id: run_tests
        run: pytest tests/

      - name: Notify Slack on failure
        if: failure()
        run: |
          curl -X POST -H 'Content-type: application/json' \
            --data "{\"text\":\"❌ Daily Playwright tests failed. Run: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}\"}" \
            "${{ secrets.SLACK_WEBHOOK_URL }}"

④ 本番環境をテストする際の注意点

「毎日実行」の目的の一つが本番環境の監視である場合、テスト対象が実際のユーザーが使っているサービスになります。ステージング環境とは異なる注意が必要です。

⑤ 無人実行特有のFlaky Test対策

push/PRトリガーであれば、テストが失敗した際にすぐ再実行ボタンを押せますが、夜間のスケジュール実行では人が即座に対応できません。無人実行では、Flaky Testによる誤検知が朝の通知への信頼性を下げてしまいます。

- name: Run Playwright tests with retry
  run: pytest tests/ --reruns 2 --reruns-delay 3

実務でよくある失敗パターン

FAQ

📋 まとめ

毎日実行の仕組みは、一度作ってしまえば「気づいたら壊れていた」を防ぐ強力な安全網になります。まずは重要な導線に絞ったスモークテストから始めて、通知の仕組みとセットで運用に乗せてみてください。