Quartz 운영 중에 가장 자주 쓰는 명령만 모은 빠른 참고용 치트시트입니다. 빌드/재시작/헬스체크/장애점검 순서로 바로 복붙해서 쓸 수 있습니다.
Tip/images/quartz-ops-cheatsheet-flow.svg
핵심 명령 4단계
# 사전 변수 (내 환경에 맞게 설정)
export QUARTZ_ROOT="<your-quartz-root>"
export QUARTZ_PORT="<your-port>"
export SITE_DOMAIN="<your-domain>"
# 1) 빌드
cd "$QUARTZ_ROOT"
npx quartz build
# 2) 재시작
pm2 restart quartz
pm2 list
# 3) 헬스체크
curl -I "http://127.0.0.1:${QUARTZ_PORT}"
curl -I "https://${SITE_DOMAIN}"
# 4) 장애 점검
pm2 logs quartz --lines 120 --nostream
ss -tlnp | grep "${QUARTZ_PORT}"원클릭 루틴
cd "$QUARTZ_ROOT" && npx quartz build && pm2 restart quartz && pm2 list장애 대응 메모
502가 보이면 보통 백엔드(QUARTZ_PORT) 미기동 또는 재시작 타이밍 이슈EADDRINUSE가 보이면 watcher/중복 프로세스 포트 충돌 가능성 확인- 최근 문서를 많이 옮기거나 지운 뒤
ENOENT가 반복되면 삭제 뒤 ENOENT 재빌드 해결부터 본다 - 반영이 늦게 보이면 브라우저 강력 새로고침(
Cmd/Ctrl + Shift + R)