Volumes

Manage shared storage between tasks.

volumes.create()

Create a volume for inter-task communication.

const vol = await volumes.create(name, sizeGiB);

• name — volume identifier
• sizeGiB — quota in gigabytes
• Returns a handle for use in runtime.run() mounts

Example

const vol = await volumes.create("workspace", 50);

await runtime.run({
  name: "setup",
  image: "alpine",
  command: { path: "mkdir", args: ["-p", "/data"] },
  mounts: { "/data": vol },
});

await runtime.run({
  name: "consume",
  image: "alpine",
  command: { path: "cat", args: ["/data/output.txt"] },
  mounts: { "/data": vol },
});

Volumes are scoped to a single pipeline execution. After the pipeline completes, volumes are cleaned up by the driver.

Parallel Task Limitation

Sharing a single volume across parallel instances of the same task (for example using YAML parallelism) is currently undefined behavior.

In practice, concurrent access semantics depend on the active orchestration driver and may vary. Prefer isolated volumes per parallel instance when writes are involved.