Options
All
  • Public
  • Public/Protected
  • All
Menu

Index

Type aliases

InputDocumentSpec

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

JobId: Opaque<ResourceId, "JobId">

JobSpec

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

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

Type declaration

  • 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. For a pending or running job, this list will be empty. For a successfully completed job, each outputDocument entry from the job spec will have a corresponding entry in this list.

  • phase: JobPhase

ListJobsFilter

ListJobsFilter: { submitter?: IdentityId }

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

Type declaration

  • Optional submitter?: IdentityId

    Selects jobs that were submitted by this identity.

OutputDocument

OutputDocument: { id: DocumentId; mountPath: string }

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

Type declaration

OutputDocumentSpec

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

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

PODJobStatusReport

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

Generated using TypeDoc