Cron 표현식 참조

고급 패턴

목록과 범위 결합

필드는 혼합 구문을 허용합니다. 평일 오전 8시와 오후 6시에 작업을 실행하려면:

0 8,18 * * 1-5

단계로 특정 월을 지정하려면:

0 0 1 1-12/3 *    # 1월부터 3개월마다 (1월, 4월, 7월, 10월)

일 vs. 요일

일과 요일이 모두 설정된 경우(*가 아닌 경우), 동작은 구현에 따라 다릅니다. 표준 cron에서는 어느 하나의 조건이 충족되면 작업이 실행됩니다 — AND가 아닌 OR 관계입니다. 이것은 많은 사람을 놀라게 합니다.

0 0 15 * 1

부팅 시 실행

엄밀히 cron 표현식은 아니지만, @reboot는 널리 지원되는 단축어입니다:

@reboot /usr/local/bin/start-service.sh

기타 일반적인 단축어:

단축어	동등한 표현식
@yearly	0 0 1 1 *
@monthly	0 0 1 * *
@weekly	0 0 * * 0
@daily	0 0 * * *
@hourly	0 * * * *

다양한 환경에서의 Cron

Linux Crontab

전통적인 방식입니다. crontab -e로 사용자 crontab을 편집합니다:

# 매일 오전 2시에 백업 실행
0 2 * * * /home/user/scripts/backup.sh >> /var/log/backup.log 2>&1

/etc/cron.d/의 시스템 전체 cron 작업에는 사용자 필드가 추가됩니다:

0 2 * * * root /usr/local/bin/cleanup.sh

GitHub Actions

GitHub Actions는 schedule 트리거 내에서 동일한 5필드 구문을 사용합니다. 모든 시간은 UTC입니다.

on:
  schedule:
    - cron: '0 3 * * 1-5'   # 평일 UTC 오전 3시

YAML 설정에 대한 자세한 내용은 Kubernetes를 위한 YAML과 Docker Compose를 위한 YAML을 참조하세요.

일반적인 함정

2. 실행 겹침

작업이 실행 간격보다 오래 걸리면 겹치는 인스턴스가 발생합니다. */5 * * * * 스케줄에서 8분이 걸리는 스크립트는 쌓이게 됩니다.

해결책:

• 잠금 파일 사용 (Linux의 flock)
• Kubernetes CronJob에서 concurrencyPolicy: Forbid 설정
• 스크립트 시작 시 실행 중인 인스턴스 확인

4. "매월 31일" 함정

0 0 31 * *    # 31일이 있는 달에만 실행

이것은 1월, 3월, 5월, 7월, 8월, 10월, 12월에 실행되지만 나머지 5개월은 조용히 건너뜁니다. 월말 작업이 필요하다면 1일에 실행하고 스크립트 로직을 조정하거나, "월의 마지막 날" 의미론을 지원하는 도구를 사용하는 것을 고려하세요.

5. Crontab 끝의 줄바꿈 누락

일부 cron 구현에서는 crontab 파일 끝에 줄바꿈이 필요합니다. 마지막 항목이 실행되지 않으면 끝에 빈 줄을 추가하세요.

Kubernetes CronJob

apiVersion: batch/v1
kind: CronJob
metadata:
  name: nightly-report
spec:
  schedule: "0 2 * * *"
  jobTemplate:
    spec:
      template:
        spec:
          containers:
            - name: report
              image: reporting:latest
              command: ["python", "generate_report.py"]
          restartPolicy: OnFailure