1. Task Scheduling

작업 스케줄링(Task Scheduling)은 컴퓨터 시스템에서 작업이나 프로세스를 효율적으로 관리하고 실행하기 위해 작업의 순서와 타이밍을 결정하는 과정이다. 작업 스케줄링은 운영 체제, 데이터베이스 관리 시스템, 분산 시스템 등 다양한 분야에서 중요한 역할을 한다.

1.1 작업 스케줄링의 주요 목표

• 효율성 : 시스템 자원을 최대한 활용하여 작업을 효율적으로 처리한다.
• 응답 시간 최소화 : 작업의 응답 시간을 최소화하여 사용자 경험을 향상시킨다.
• 공정성 : 모든 작업이 공정하게 자원을 할당받을 수 있도록 한다.
• 우선순위 관리 : 중요한 작업이 우선적으로 처리될 수 있도록 우선순위를 관리한다.

1.2 작업 스케줄링의 유형

1. 선점형 스케줄링(Preemptive Scheduling)
   • 작업이 실행 중일 때, 더 높은 우선순위의 작업이 도착하면 현재 작업을 중단하고 새로운 작업을 실행한다.
   • e.g. 라운드 로빈(Round Robin), 우선순위 스케줄링(Priority Scheduling)
2. 비선점형 스케줄링(Non-preemptive Scheduling)
   • 작업이 실행을 시작하면, 작업이 완료될 때까지 다른 작업이 실행되지 않는다.
   • e.g. FCFS(First-Come, First-Served), SJF(Shortest Job First)

1.3 작업 스케줄링 알고리즘

• FCFS (First-Come, First-Served) : 먼저 도착한 작업을 먼저 처리한다.
• SJF (Shortest Job First) : 실행 시간이 가장 짧은 작업을 먼저 처리한다.
• Round Robin : 각 작업을 일정 시간 동안 번갈아 가며 처리한다.
• Priority Scheduling : 우선순위가 높은 작업을 먼저 처리한다.
• Multilevel Queue Scheduling : 작업을 여러 개의 큐로 나누어 각 큐에 다른 스케줄링 알고리즘을 적용한다.

1.1 Task Scheduling의 용도

• 메일링 리스트에 추천 영화 리스트를 주기적으로 보내줄때.
• 총 좋아요 갯수나 총 조회수처럼 특정 데이터를 주기적으로 업데이트할때
• 주기적으로 데이터나 파일을 정리할때
• 주기적으로 데이터 분석 리포트를 제작할때
• 주기적으로 데이터베이스를 백업할때

2. Cron 문법

• 초 0-59 : 0초부터 59초까지의 숫자를 입력한다
• 분 0-59 : 0분부터 59분까지의 숫자를 입력한다
• 시 0-23 : 0시부터 23시까지의 숫자를 입력한다
• 일 1-31 : 1일부터 31일까지의 숫자를 입력한다
• 월 1-12 : 1월부터 12월까지의 숫자를 입력한다
• 요일 0-7 : 0부터 7까지의 숫자가 각 [일,월,화,수,목,금,토,일]에 해당된다. 일요일은 두번 있다

1
* * * * * * 실행할 커맨드
2
- - - - - -
3
| | | | | |
4
| | | | | +-- 요일 (0 - 7) (일요일은 0과 7이 모두 가능)
5
| | | | +---- 월 (1 - 12)
6
| | | +------ 일 (1 - 31)
7
| | +-------- 시 (0 - 23)
8
| +---------- 분 (0 - 59)
9
+------------ 초 (0 - 59)

• *[별] : 필드의 모든 값을 매칭한다. (e.g. 1초마다 실행)
• , [컴마] : 여러개의 값을 구분한다. (e.g. ‘일’ 위치에 1,2,3 입력 → 1일, 2일, 3일에 실행)
• -[하이픈] : 범위를 표현한다. (e.g. ‘요일’ 위치에 1-3 입력→ 월요일부터 수요일에 해당될때)
• / [슬래시] : 배수를 표현한다. (e.g. ‘분’ 위치에 */15 입력 → 15분마다 실행 (0, 15, 30, 45분)
• L [알파벳 엘] : 달의 마지막 날을 의미한다. (e.g. ‘요일’ 위치에 5L 입력 → 달의 마지막 금요일)
• W [알파벳 더블유] : ‘일’ 위치에 입력시 가까운 평일 (e.g. ‘일’ 위치에 15W 입력 → 15일에 가장 가까운 평일)
• # [샾] : 몇번째 요일인지 표현한다. (e.g. ‘요일’ 위치에 5#3 입력 → 달의 세번째 금요일)

2.1 Cron 예제

1
# 0초마다 실행(1분에 한번 실행)
2
0 * * * * *
3

4
# 정확히 자정에 실행 (0초 0분 0시)
5
0 0 0 * * *
6

7
# 일요일 3시 0분 30초에 실행 (일요일 3:00:30AM)
8
30 0 3 * * 0
9

10
# 매월 마지막 날 5시 30분 45초에 실행 (매월 마지막 날 5:30:45PM)
11
45 30 17 L * *
12

13
# 월,수,금 10시15분에 실행 (월,수,금 10:15:00AM)
14
0 15 10 * * 1,3,5
15

16
# 0초 5분마다 실행 (5분마다 실행, 시 정각에 시작)
17
0 */5 * * * *
18

19
# 8시와 20시 사이에 2시간마다 실행
20
0 0 8-20/2 * * *
21

22
# 매월 마지막 금요일 11:00:00PM에 실행
23
0 0 23 * * 5L
24

25
# 1초마다 실행
26
* * * * * *
27

28
# 30초마다 실행
29
*/30 * * * * *

3. NestJS Schedule 선언형

1
import { Injectable, Logger } from '@nestjs/common'
2
import { Cron } from '@nestjs/schedule'
3

4
@Injectable()
5
export class TaskService {
6
  private readonly logger = new Logger(TaskService.name)
7

8
  @Cron('45 * * * * *')
9
  handleCron() {
10
    this.logger.debug('Called when the current second is 45')
11
  }
12
}

4. NestJS Schedule 옵션

1
import { Injectable } from '@nestjs/common'
2
import { Cron, CronExpression } from '@nestjs/schedule'
3

4
@Injectable()
5
export class NotificationService {
6
  @Cron('* * 0 * * *', {
7
    name: 'notifications',
8
    timeZone: 'Europe/Paris',
9
  })
10
  triggerNotification() {}
11
}

5. SchedulerRegistry 함수

1
addCronJob(name: string, seconds: string) {
2
  const job = new CronJob(`${seconds} * * * * *`, () => {
3
    this.logger.warn(`time (${seconds}) for job ${name} to run!`)
4
  })
5

6
  this.schedulerRegistry.addCronJob(name, job)
7
  job.start()
8

9
  this.logger.warn(
10
    `job ${name} added for each minute at ${seconds} seconds`,
11
  )
12
}
13

• stop() : 예정된 작업을 중지한다.
• start() : stop()이 실행된 작업을 재실행한다.
• setTime(time: CronTime) : 작업을 중지하고 새로운 주기를 지정하고 시작한다.
• lastDate() : 마지막으로 작업이 실행된 날짜를 반환한다.
• nextDate() : 다음으로 작업이 실행될 날짜를 반환한다.
• nextDates(count: number) : 다음으로 작업이 실행될 날짜들을 n개 반환한다

6. Versioning

• URL Versioning : URI에 버전이 전달된다 /v1/movie
• Header Versioning Header에 버전이 전달된다 version: 1
• Media Type Versioning : Header의 Accept 키에 버전이 전달된다. Accept: application/json;v=2