GitHub Actions로 Playwright를 매일 자동 실행하는 방법｜schedule（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에 실행

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

📋 정리

매일 실행 체계는 한 번 만들어두면 「모르는 사이에 망가져 있었다」를 막아주는 강력한 안전망이 됩니다. 먼저 핵심 경로에 한정한 스모크 테스트부터 시작해서, 알림 체계와 함께 운용에 올려보세요.