Skip to content
agent-cms
업그레이드 / 0.12로 올리기

업그레이드 / upgrade-0-12

0.12로 올리기

스키마는 버전 6이에요. 작업과 웹훅 표 세 개가 늘어요. cron 호출이 웹훅도 보내요. 웹훅은 secretsKey를 설정해야 켜져요.

수정 2026년 11월 21일편집 docs seed버전 1
이 페이지

1. 스키마 버전 6#

표 세 개가 늘어요: cms_jobs, cms_webhooks, cms_webhook_deliveries. 기존 표는 바뀌지 않아요.

npx @mainsoft/agent-cms migrate check
npx @mainsoft/agent-cms migrate apply     # 또는 `migrate print`로 SQL을 받아 직접 실행

Drizzle 스키마 파일에서 표를 다시 내보내고 있다면 cmsJobs, cmsWebhooks, cmsWebhookDeliveries를 추가하세요(새로 init하면 들어 있어요).

2. cron 호출이 하는 일이 늘었어요#

POST /_cron은 예약 게시와 휴지통 비우기를 했어요. 이제 백그라운드 작업도 실행하고, 웹훅이 이때 나가요. 응답에 jobs 필드({ran, ok, retried, failed, waiting})가 생겼고 기존 필드는 그대로예요. 하루 한 번 부르면 웹훅도 하루 한 번 나가요. 웹훅을 쓴다면 1분쯤 간격으로 부르세요. cron 서비스가 없으면 npx @mainsoft/agent-cms cron --watch를 쓰세요.

3. 웹훅은 켜야 동작해요#

secretsKey(32자 이상)를 설정하고 관리자가 웹훅을 만들기 전에는 아무것도 보내지 않아요. 화면은 npx @mainsoft/agent-cms add cms-webhooks로 받고 /admin/webhooks 페이지를 만드세요.

4. 화면#

npx @mainsoft/agent-cms add --update가 cms-shell(웹훅 메뉴, 플러그인 메뉴)과 cms-messages를 가져와요. 다른 화면은 그대로예요.

5. 타입#

  • CollectionConfig.hooks에 beforeChange, beforePublish, beforeDelete가 생겼어요.
  • CreateCmsOptions에 secretsKey, webhooks, plugins, onEvent가 생겼어요.
  • 직접 만든 CmsRepo는 작업과 웹훅 메서드(insertJob, claimJobs, … failWebhook, pruneDeliveries)가 필요해요. MemoryRepo와 DrizzleRepo에는 들어 있어요.
  • 새 오류 코드: webhook_not_found, delivery_not_found, forbidden_webhooks, secrets_key_missing, webhook_url_blocked, webhook_event_unknown, hook_rejected.