Cron Worker¶

A Pacto contract for a scheduled batch job — a stateless worker that runs on a cron schedule.

pactoVersion: "1.2"

service:
  name: report-generator
  version: 1.2.0
  owner:
    team: analytics
  image:
    ref: ghcr.io/acme/report-generator:1.2.0
    private: true

interfaces:
  - name: health
    type: http
    port: 8080
    visibility: internal

runtime:
  workload: scheduled

  state:
    type: stateless
    persistence:
      scope: local
      durability: ephemeral
    dataCriticality: low

  health:
    interface: health
    path: /ready

metadata:
  schedule: "0 2 * * *"
  timeout: 3600

Key decisions¶

workload: scheduled — runs on a cron schedule, not continuously
No scaling section — batch workloads don't scale horizontally. pacto validate rejects a scaling block on job workloads (JOB_SCALING_NOT_ALLOWED); on a scheduled workload it is allowed but omitted here by convention
No lifecycle section — upgrade strategy doesn't apply to jobs
Schedule in metadata — the cron expression is platform-specific, so it lives in metadata, not the contract's core fields

Variant: One-shot job¶

For a job that runs once (e.g., a database migration):

runtime:
  workload: job
  state:
    type: stateless
    persistence:
      scope: local
      durability: ephemeral
    dataCriticality: low
  health:
    interface: health
    path: /ready