• Public
  • Public/Protected
  • All


Type aliases


InputDocumentSpec: { id: DocumentId; mountPath: string }

Input document for a compute job.

Type declaration

  • id: DocumentId

    ID of the document to mount.

  • mountPath: string

    Path where the input document will be mounted inside the job. Interpreted relative to /parcel/data/in.


JobId: Opaque<ResourceId, "JobId">


JobSpec: { cmd: string[]; cpus?: number; env?: Record<string, string>; image: string; inputDocuments?: InputDocumentSpec[]; memory?: string; name: string; outputDocuments?: OutputDocumentSpec[] }

A specification/manifest for the job. This is a complete description of what and how the job should run.

Type declaration

  • cmd: string[]

    The command-line arguments to the command that should be run to start the job. This corresponds to CMD in Docker terminology; note that images running on Parcel are required to have a non-empty ENTRYPOINT, so the actual command that runs will be the concatenation of ENTRYPOINT and this field.

  • Optional cpus?: number

    The (fractional) number of cpus requested to run the job. This is clamped by a per-worker maximum.

  • Optional env?: Record<string, string>

    Environment variables to use when running the image. Setting PATH is not allowed.

  • image: string

    The name of the docker image to use, optionally prefixed with an image repository hostname. See docker pull documentation for a full description of allowable formats.

  • Optional inputDocuments?: InputDocumentSpec[]

    Documents to download and mount into the job's container before cmd runs. If any of these documents do not exist or you do not have permission to access them, the job will fail.

  • Optional memory?: string

    The amount of memory requested to run the job. This is clamped by a per-worker maximum. Memory limit (format: []). Number is a positive integer. Unit can be one of M or G. Minimum is 4M.

  • name: string

    A human-readable name for the job. Intended to help with monitoring and debugging. The name SHOULD be unique among jobs submitted by the same user.

  • Optional outputDocuments?: OutputDocumentSpec[]

    Files to be uploaded from the job's container as documents after cmd runs. Files that do not exist will be silently skipped; the job will not fail.


JobStatus: { accessedDocuments: DocumentId[]; host?: string; message?: string; outputDocuments: OutputDocument[]; phase: JobPhase }

Type declaration

  • accessedDocuments: DocumentId[]

    Documents that were accessed by the job. Includes both the prespecified JobSpec.input_documents as well as any dynamically accessed documents.

  • Optional host?: string

    A reference to the worker hosting (running) this job, if any. This field is intended for human reference/debugging only for now, so no semantics are prescribed for the endpoint at the host address.

  • Optional message?: string

    A human readable message indicating details about why the pod is in this condition.

  • outputDocuments: OutputDocument[]

    Documents that were generated by the job and uploaded by the Parcel Worker.

  • phase: JobPhase


ListJobsFilter: { inputOwner?: IdentityId; submitter?: IdentityId }

Filters for specifying the subset of jobs to be listed/fetched.

Type declaration

  • Optional inputOwner?: IdentityId

    Selects jobs that used documents owned by this identity.

  • Optional submitter?: IdentityId

    Selects jobs that were submitted by this identity.


OutputDocument: { id: DocumentId; mountPath: string }

An output document produced in the context of running a job.

Type declaration


OutputDocumentSpec: { mountPath: string; owner?: IdentityId }

Specification for a compute job for outputting a document.

Type declaration

  • mountPath: string

    Path to the file that should be uploaded as an output document. Interpreted relative to /parcel/data/out.

  • Optional owner?: IdentityId

    Owner to assign to the output document.


PODJob: Readonly<PODModel & { id: JobId; spec: JobSpec; status?: JobStatus }>


PODJobStatusReport: Readonly<PODModel & { id: JobId; status: JobStatus }>

Generated using TypeDoc