[스케줄링]Spring Scheduler로 임시 첨부파일 정리하기

 

Spring 스케줄링

 

https://docs.spring.io/spring-framework/reference/integration/scheduling.html

Task Execution and Scheduling :: Spring Framework

 

 

 

Spring 스케줄링은 쉽게 말해 서버가 켜져있는 동안, 내가 정한 시간마다 특정 메서드를 자동 실행하게 만드는 기능이다

Spring아, 이 프로젝트에서 @Scheduled붙은 메서드를 찾아서 자동 실행해줘 -> @EnableScheduling

@Configuration
@EnableScheduling
public class SchedulingConfig {
}

공식문서에서는 "To enable support for @Scheduled … add @EnableScheduling to one of your @Configuration classes."라고 나와있다 즉 @Scheduled 기능을 사용하려면 설정 크랠스 중 하나에 @EnableScheduling을 추가하라는 말이다

@Configuration : Spring 설정 파일 역할을 하는 클래스라는 표시

@EnableScheduling : Spring에게 스케줄링 기능 켜라라고 알려주는 어노테이션 - 스위치

이 메서드를 매일 새벽 3시에 자동 실행해줘 -> @Scheduled

@Component
public class AttachmentCleanupScheduler {

    @Scheduled(cron = "0 0 3 * * *")
    public void deleteOldTempAttachments() {
        // 오래된 임시 첨부파일 삭제
    }
}

공식문서에서는 "You can add the @Scheduled annotation to a method, along with trigger metadata."라고 나와있다

즉, 메서드에 @Scheduled를 붙이고 언제 실행할지에 대한 실행 조건도 같이 적을 수 있다는 말이다 여기서 중요한 건 컨트롤러처럼 사용자의 요청이 들어와야 실행되는 게 아니라는 것.

서버 켜짐
→ 정해진 시간이 됨
→ Spring이 알아서 메서드 실행

trigger metadata : 언제 실행할지 알려주는 초기값 (cron, fixedDelay, fixedRate)

아래 메서드는 5초마다 실행해줘 -> fixedDelay

@Scheduled(fixedDelay = 5000)
public void doSomething() {
    // something that should run periodically
}

공식문서에서는 이 메서드가 이렇게 동작한다고 설명하고 있다 "the period is measured from the completion time of each preceding invocation." 다음 실행까지의 시간은 이전 실행이 끝난 시점부터 계산된다는 말이다

예를들면

12:00:00 작업 시작
12:00:03 작업 끝남
fixedDelay = 5초
12:00:08 다음 작업 시작

---

 Spring 스케줄링의 기본 선택지

1. fixedDelay
2. fixedRate
3. cron
+ initialDelay

1. fixedDelay

https://docs.spring.io/spring-framework/docs/4.2.7.RELEASE/spring-framework-reference/html/scheduling.html

33. Task Execution and Scheduling

 

 

 

fixedDelay는 이전 작업이 끝난 뒤 정해진 시간만큼 기다렸다가 다음 작업을 실행하는 방식이다 위에서 다룬 것처럼, 공식문서에서는 " The fixedDelay attribute … makes sure that there is a delay of five seconds between the finish time of an execution and the start time of the next execution."라고 설명하고 있다 fixedDelay는 한 번 실행이 끝난 시점과 다음 실행이 시작되는 시점 사이에 5초 간격으로 보장한다는 말이다

@Scheduled(fixedDelay = 5000)
public void cleanup() {
    // 작업 실행
}

12:00:00 작업 시작
12:00:03 작업 끝
5초 기다림
12:00:08 다음 작업 시작

장점

이전 작업이 끝난 뒤 다음 작업이 시작되는 거라 안전하다 작업 시간이 길어져도 끝나고 나서 다시 시작이라는 흐름이 덜 꼬이기 때문이다

단점

정확히 매 5초 매 1분 같은 고정시각을 보장하지는 않는다

작업 시간이 길어지면 전체 실행 간격도 밀린다

작업 3초 + 대기 5초 = 다음 실행은 8초 뒤
작업 10초 + 대기 5초 = 다음 실행은 15초 뒤

 

언제 사용하는 게 적절할까? 했을 땐 외부 API동기화, 파일 정리, DB정ㄹ, 메일 재시도, 로그 정리 등에 적절해 보인다

 

2. fixedRate

fixedRate는 작업 시작 시각을 기준으로 일정 간격마다 실행하려는 방식이다

@Scheduled(fixedRate = 5000)
public void collectMetrics() {
    // 작업 실행
}

공식문서에서 fixedRate도 주기 실행 속석으로 제시되고 있다 Spring @Scheduled javadoc은 반복 작업에서 cron, fixedDelay, fixedRate 중 하나를 지정한다고 설명한다 

12:00:00 작업 시작
12:00:05 다음 작업 시작 예정
12:00:10 다음 작업 시작 예정

즉, 시작 기준으로 5초마다라고 생각하면 이해하기 쉽다

장점

일정한 주기로 계속 실행하려는 작업에 좋다 예를들어 10초마다 현재 서버 상태를 수집하기 같은 건 시작 간격이 중요하다

단점

작업이 오래 걸리면 밀리거나 겹침 문제가 생길 수 있다

Spring 공식문서는 같은 메서드에 여러 스케줄 선언이 있으면 독립적으로 처리되고 서로 겹쳐 병렬 실행되거나 바로 이어 실행될 수 있으니 겹치지 않게 주의하라고 말하고 있다

"such co-located schedules may overlap and execute multiple times in parallel or in immediate succession"

 

언제 사용하는 게 적절할까? 했을 땐 10초마다 메트릭 수집, 1분마다 상태 체크, 일정주기로 캐시 갱신 시도 등에 적절해 보인다

 

3. cron

몇 초, 몇 분, 몇 시, 몇 일, 몇 월, 무슨 요일에 실행할지를 식으로 정리하는 방식이다

@Scheduled(cron = "0 0 3 * * *")
public void cleanupOldTempFiles() {
    // 매일 새벽 3시 실행
}

" A well-formed cron expression, such as * * * * * *, consists of six space-separated time and date fields, each with its own range of valid values. " Spring 공식문서는 cron 표현식이 정해진 형식을 따라야 한다고 설명하고 있다

cron 표현식은 6개의 칸으로 표현된다는 말이다

초 분 시 일 월 요일
0  0  3  *  *  * -> 매일 03:00:00

장점

사람이 이해하기 쉬운 운영 시간 기준으로 실행할 수 있다

예를들어 매일 새벽3시, 매주 월요일 오전 9시, 매달 1일 0시, 평일 18시.

이런 식의 달력 기준 작업에 좋다

단점

표현식이 익숙하지 않으면 헷갈린다

0 0 3 * * *

처음보면 뭔 소린지 모른다 

두번째로, 작업이 오래 걸릴 경우 다음 실행 시점과 겹칠 수 있는지 고려해야 한다 특히 서버가 여러대면 중요해진다

서버 1대 → 새벽 3시에 1번 실행
서버 2대 → 각 서버에서 새벽 3시에 실행될 수 있음

EC2 한 대면 단순하지만, 나중에 서버가 여러 대가 되면 중복 실행 방지도 고민해야 한다

 

언제 사용하는 게 적절할까? 라고 했을 땐 정해진 시각에 실행해야 하는 운영 작업인 경우에 적절해 보인다

 

4. initialDelay

initialDelay는 서버 켜진 뒤 바로 실행하지 말고 처음 실행만 조금 늦추는 옵션이다

@Scheduled(initialDelay = 10000, fixedDelay = 60000)
public void cleanup() {
    // 서버 시작 10초 후 첫 실행
    // 이후 이전 작업 종료 후 60초마다 실행
}

공식문서 javadoc은 initialDelay를 이렇게 설명하고 있다

"Number of units of time to delay before the first execution" 첫번째 실행 전에 얼마나 기다릴지 정하는 값이라는 뜻이다

https://github.com/spring-projects/spring-framework/blob/main/spring-

context/src/main/java/org/springframework/scheduling/annotation/Scheduled.java

spring-framework/spring-context/src/main/java/org/springframework/scheduling/annotation/Scheduled.java at main · spring-project

 

 

장점

서버 시작 직후 무거운 작업이 바로 도는 걸 막을 수 있다

서버가 막 켜져있을 때는 애플리케이션 초기화, DB 연결, 캐시 준비 등으로 바쁠 수 있따 그때 스케줄러까지 바로 돌면 부담이 될 수 있다

단점

단독으로 반복 주기를 정하는 핵심 방식은 아니다 대부분 fixedDelay나 fixedRate와 같이 쓴다

 

 

방식	기준	장점	단점	어울리는 작업
fixedDelay	이전 작업 종료 후	이전 작업 끝난 뒤 실행이라 안전함	정확한 시각 실행은 아님	파일 정리, 재시도, DB 정리
fixedRate	이전 작업 시작 후	일정 주기로 실행하려 할 때 좋음	작업이 오래 걸리면 밀림/겹침 고려	메트릭 수집, 상태 체크
cron	달력/시각	매일 3시 같은 운영 시간 설정 가능	표현식이 헷갈리고 중복 실행 고려 필요	새벽 정리, 통계, 정산
initialDelay	첫 실행 전	서버 시작 직후 부담 방지	반복 방식 자체는 아님	fixedDelay, fixedRate 보조