🔫 django-crontab 사용하기

📣 본문은 2019년 10월 19일 작성한 글입니다.

개요

매일 정각에 새로운 필드를 만들어내야 하는 기능이 필요하게 됐다.

주기적으로 함수를 실행하기 위해 django-crontab을 사용한 경험을 정리한다.

설치 및 설정

다음 명령어를 통해 설치한다.

pip install django-crontab

설치를 완료했다면, settings.py의 INSTALLED_APPS에 django_crontab을 추가해주자.

INSTALLED_APPS = (
    'django_crontab',
    ...
)

이제 cron에게 넘겨줄 업무 함수를 구현한다. 간단하게 1분마다 hello를 출력하도록 하는 함수를 만들어 테스트해보자. app 폴더 하위에 cron.py 파일을 만들고 함수를 정의한다.

def hello_every_minute():
    print('hello')

이 함수를 cron에게 넘겨주어야 한다. 다시 settings.py로 돌아가서 다음과 같이 작성해준다.

CRONJOBS = [
    ('* * * * *', 'app.cron.hello_every_minute', '>> /tmp/log/ggbc_cron.log'),
]

CRONJOBS 리스트에는 여러 개의 Job을 넣어줄 수 있다.

첫 번째 인자에는 업무를 어느 주기로 실행할지에 대한 내용이다. 처음부터 분, 시, 일, 월, 요일에 대한 값이며 모두 *인 경우에는 매 분마다 실행한다.

예를 들어 필자와 같이 자정마다 이 작업을 실행하고 싶으면 '* 0 * * *'과 같이 작성해주면 된다. 일주일마다 돌고 싶으면 '* * */3 * *'과 같이 작성해준다.

슬래시(/)가 있으면 매 분(또는 시, 일, 월, 요일)마다 실행하는 것이고 없으면 특정 시간에 실행한다는 뜻이 된다. 슬래시와 숫자 사이에 공백이 없도록 주의하자.

두 번째 인자는 업무 함수의 경로이다.

세 번째 인자는 cron 실행 로그를 쌓을 파일의 경로이다. 출력값을 매번 확인할 수 없으니 위와 같이 로그 파일로 저장하도록 하자.

실행

다음 명령어로 cron에게 업무들을 추가해주자.

python manage.py crontab add

잘 들어갔는지 확인하기 위해 다음 명령어로 현재 cron에 부여된 업무 리스트를 확인하자.

python manage.py crontab show

업무들이 한 리스트(CRONJOBS) 안에 있으므로 한 번에 삭제되고 한 번에 추가된다. 삭제하는 명령어는 다음과 같다.

python manage.py crontab remove

삭제할 때 에러가 난다면 추가 명령어를 다시 해보고 삭제해보자.