CronBark 문서는 베타입니다 — 피드백은 cronbark.contact@gmail.com
연동 방법CLI

CronBark CLI

cronbark CLI는 Python SDK와 함께 설치되는 명령줄 도구입니다. 기존 crontab을 한 줄도 수정하지 않고 모니터링을 추가할 수 있습니다.

⚠️

베타 프리뷰 (v0.0.1) — 옵션이 정식 출시(v0.1.0) 전까지 변경될 수 있습니다.

설치

pip install cronbark
cronbark --version
# 0.0.1

자세한 설치 방법은 설치 페이지 참고.

핵심 명령: cronbark exec

기존 명령을 cronbark exec로 감싸면:

  • 실행 전 start 이벤트 자동 전송
  • exit code 0 → success, 아니면 fail 자동 판정
  • stdout/stderr 자동 캡처해서 실패 시 로그로 첨부
cronbark exec --token YOUR_TOKEN "python backup.py"

환경변수로 토큰을 설정해두면 --token을 생략할 수 있습니다:

export CRONBARK_TOKEN=YOUR_TOKEN
cronbark exec "python backup.py"

서버 URL을 바꾸려면 CRONBARK_URL 환경변수를 사용하거나, 서브커맨드 앞에 --url 옵션을 붙입니다 (그룹 레벨 옵션이라 위치가 중요합니다):

# 환경변수 방식 (권장)
export CRONBARK_URL=https://cronbark.example.com
cronbark exec "python backup.py"
 
# 또는 --url을 앞에 붙인다
cronbark --url https://cronbark.example.com exec --token YOUR_TOKEN "python backup.py"

crontab 연동 예시

Before — 원래 crontab

0 * * * * /usr/bin/python3 /opt/scripts/backup.py

After — CronBark 모니터링 추가

0 * * * * cronbark exec --token abc123 "/usr/bin/python3 /opt/scripts/backup.py"

또는 환경변수를 쓰는 경우:

CRONBARK_TOKEN=abc123
0 * * * * cronbark exec "/usr/bin/python3 /opt/scripts/backup.py"

개별 이벤트 명령

자동화가 맞지 않는 경우 직접 이벤트를 보낼 수도 있습니다.

cronbark ping YOUR_TOKEN                          # start + success 한 번에
cronbark start YOUR_TOKEN                         # 실행 시작
cronbark success YOUR_TOKEN                       # 성공 완료
cronbark fail YOUR_TOKEN --msg "Connection refused"  # 실패
cronbark tick YOUR_TOKEN                          # 하트비트 (start 없는 성공)

crontab 자동 스캔: cronbark discover

현재 시스템 crontab을 스캔해서 감싸지 않은 잡을 찾아줍니다.

cronbark discover

출력 예:

발견된 크론잡 3개:
#    스케줄              명령어
1    */5 * * * *         /scripts/backup.sh
2    0 * * * *           /scripts/report.py
3    0 0 * * *           /scripts/cleanup.sh

주요 옵션

옵션위치설명
--url <URL>그룹 레벨 (cronbark --url ... <subcommand>)서버 URL. 환경변수 CRONBARK_URL로 대체 가능 (기본: https://api.cronbark.com)
--token <TOKEN>exec 서브커맨드API 토큰. 환경변수 CRONBARK_TOKEN로 대체 가능
--msg <MSG>fail 서브커맨드에러 메시지

종료 코드

  • cronbark exec은 감싼 원 명령의 종료 코드를 그대로 반환합니다.
  • CronBark 서버 오류가 있어도 원 작업이 성공했다면 exit 0입니다 (모니터링 때문에 잡이 실패하지 않도록).

다음 단계

Python SDKIncoming Webhooks