작업 스케줄링은 어떻게 동작하나요?

Question

작업 스케줄링은 어떻게 동작하나요?

Accepted Answer

Laravel의 **작업 스케줄러(task scheduler)**는 예약된(반복) 작업 — 일일 리포트, 정리, 알림 전송 등 — 을 여러 개별 cron 항목을 관리하는 대신 **코드로** 유연하게 정의할 수 있게 합니다. 단일 cron 항목이 Laravel의 스케줄러를 실행하고, 그것이 정의된 작업들을 예정된 시각에 실행합니다.

## 해결하는 문제

```text
전통적으로 각 반복 작업은 서버에 자체 crontab 항목이 필요함
→ 흩어져 있고, 버전 관리하기 어렵고, 서버에 종속되며, 오류가 발생하기 쉬움.
Laravel: 모든 예약 작업을 코드로 정의 (버전 관리됨), 단 하나의 cron 항목으로.
```

## 예약 작업 정의 (코드로)

```php
<?php
// 스케줄 정의에서 (app/Console/Kernel.php 또는 routes/console.php)
$schedule->command('reports:generate')->daily();
$schedule->command('emails:reminders')->hourly();
$schedule->job(new CleanupJob)->everyFifteenMinutes();
$schedule->call(fn() => DB::table('sessions')->where(...)->delete())->dailyAt('02:00');

// 표현력 있는 빈도 메서드:
->everyMinute() ->hourly() ->daily() ->weekly() ->monthly()
->dailyAt('13:00') ->weekdays() ->cron('0 0 * * *')   // 또는 원시 cron 표현식
```

작업은 **유연하고 읽기 쉬운 API**로 정의됩니다 — Artisan 명령어, 큐에 쌓인 작업, 또는 클로저를 표현력 있는 빈도 메서드(`daily()`, `everyFifteenMinutes()`, `dailyAt()`)로 스케줄링할 수 있으며, 흩어진 crontab 항목이 아닌 버전 관리되는 코드로 작성합니다.

## 그것을 구동하는 단일 cron 항목

```bash
# 서버에 하나의 cron 항목 추가 — 매분 스케줄러 실행
* * * * * cd /path-to-app && php artisan schedule:run >> /dev/null 2>&1
```

이 하나의 항목이 매분 `schedule:run`을 실행하고, Laravel은 정의된 작업 중 어느 것이 실행될 차례인지 확인하여 실행합니다. crontab을 다시 건드리지 않습니다 — 모든 스케줄링이 코드에 존재합니다.

## 유용한 옵션

```php
$schedule->command('backup')->daily()
    ->withoutOverlapping()        // 이전 실행이 아직 진행 중이면 시작하지 않음
    ->onOneServer()                // 다중 서버 설정에서 하나의 서버에서만 실행
    ->emailOutputOnFailure('ops@x.com');
```

## 왜 중요한가

작업 스케줄링은 **반복적인 백그라운드 작업**이 있는 모든 애플리케이션에 중요합니다 — 일일 리포트, 주기적 정리, 알림/다이제스트 전송, 데이터 동기화, 배치 처리 — 이는 일반적인 요구이며, Laravel의 스케줄러는 그러한 작업 관리를 전통적인 cron보다 훨씬 깔끔하게 만듭니다.

핵심 이점은 모든 예약 작업을 흩어지고 서버에 종속된 crontab 항목이 아닌 **버전 관리되는 코드로 유연하게** 정의하는 것입니다: 이는 스케줄링 로직을 애플리케이션과 함께 유지(검토 가능, 배포 가능, 환경 간 일관됨)하고, cron 문법보다 훨씬 읽기 쉬운 표현력 있는 API(`daily()`, `everyFifteenMinutes()`, `dailyAt()`)를 사용합니다.

영리한 설계 — 매분 `schedule:run`을 실행하는 **단일 cron 항목**이 실행될 차례인 작업을 수행 — 는 cron을 한 번 설정하면 다시 건드리지 않고 모든 스케줄링을 코드에서 관리함을 의미합니다.

예약 작업을 정의하는 방법(명령어, 작업, 빈도 메서드가 있는 클로저), 단일 cron 항목 설정, 그리고 유용한 옵션(다중 서버 안전을 위한 `withoutOverlapping`, `onOneServer`)을 이해하는 것은 반복적인 자동화 작업을 수행하는 애플리케이션을 구축하는 데 가치 있는 지식입니다.

예약/주기적 작업은 빈번한 실제 요구사항이고, Laravel의 스케줄러가 원시 cron 항목 관리에 대한 깔끔하고 버전 관리되며 표현력 있는 대안을 제공하므로, 작업 스케줄링이 어떻게 동작하는지 아는 것은 자동화된 반복 작업이 있는 유지보수 가능한 애플리케이션을 구축하는 데 중요한 시니어 수준의 지식입니다 — 스케줄러가 우아하게 처리하는 일반적이고 실용적인 요구입니다.