KissMeBatch
KissMeBatch 는 command line batch 작업을 위해서 특별하게 구현된 도구입니다.
KISS 의 REST API 가 20 tps 로 제한이 있기 때문에, 동시에 여러 process 에서 batch 작업을 수행하다가, tps 제한에 걸려서 API 호출이 실패하는 것을 막기 위함입니다.
Features
이 도구는 다음과 같은 기능을 지원합니다.
- job 의 반복수행 주기를 설정합니다. (일/시간/분/초) 단위로 설정할 수 있습니다.
- 특정 요일에만 수행되도록 week day 를 지정할 수 있습니다. (ex. 월~금)
- 주식 휴장일 여부를 체크하여 수행하지 않도록 지정할 수 있습니다. 이를 위해선 data/holiday.csv 가 필요로 합니다.
- job 마다 처리 결과를 알 수 있도록 console logging 을 지원합니다.
- job 을 시작하기 전에, 이미 수행중인 process 가 존재하면 wait or kill 을 수행합니다.
- batch.json 의 설정 파일을 주기적으로 reloading 하여 새롭게 job 을 재구성합니다. (10초마다 확인)
batch.json
batch.json 은 다음과 같은 형식으로 구성합니다.
{
"groups": [{
"maxTps": 29,
"jobs": [{
"name": "Candle minute",
"startAt": "2023-06-14 18:30:00",
"endAt": "23:59:00",
"interval": "1D",
"weeks": ["MON", "TUE", "WED", "THU", "FRI"],
"estimatedTps": 29,
"command": "KissMeConsole"
}]
}]
}
groups
maxTps- groups 에는 각 group 내의 작업이 동시에 실행될 때, maxTps 에 제한이 걸리지 않도록 조정합니다.
- 한개의 job 이 maxTps 를 모두 차지 않지 않도록 설계하는 것이 중요합니다.
jobs- 하나의 group 으로 묶을 job 설정합니다.
jobs
name- jobs 에는 job name 을 설정할 수 있습니다. console logging 에서 이를 바탕으로 로그를 출력합니다.
startAt- startAt 은 job 의 시작 시간을 지정합니다. 만약 이 값이 생략되어 있다면, 현재 시간이 시작 시간입니다.
- startAt 은 yyyy-MM-dd HH:mm:ss 또는 HH:mm:ss 로 지정할 수 있습니다.
endAt- endAt 은 job 의 종료 시간을 지정합니다. 이 시간 이후에는 job 을 수행하지 않습니다.
- endAt 은 yyyy-MM-dd HH:mm:ss 또는 HH:mm:ss 로 지정할 수 있습니다.
interval- interval 은 startAt 에서 job 을 처음 수행한 이후에 다음 job 을 언제 시작할지 지정하는 대기 시간입니다.
weeks- weeks 은 job 이 수행될 요일을 제한합니다. 만약 아무런 설정이 없다면, 어느 요일이든 수행합니다.
estimatedTps- 지정된 command 가 차지하게될 tps 를 설정합니다. 만약 아무런 값이 없다면, 기본 값으로 1로 설정됩니다.
command- job 이 수행하게 될 명령어 입니다.