stado schedule create
Invocation
stado schedule create [OPTIONS] --cron <CRON> <COMMAND>Purpose
Create a recurring schedule that submits COMMAND on a cron schedule
Required inputs and options
| Input or option | Contract |
|---|---|
<COMMAND> | Positional input; required or optional as shown in the invocation. |
--cron <CRON> | 5-field cron expression, e.g. "0 2 * * *" (daily 02:00) |
--tz <TZ> | IANA timezone the cron is interpreted in (default UTC) [default: UTC] |
--provider <PROVIDER> | Optional provider constraint; Stado chooses when omitted [default: ""] |
--pin-provider | Pin to --provider, or let any consumer claim (default) |
--any-provider | Let any consumer claim (default) |
--spot | Dispatch on Spot/Preemptible GPUs |
--no-spot | Do not dispatch on Spot/Preemptible GPUs (default) |
--max-cost-per-hour <MAX_COST_PER_HOUR> | Hard $/hour cap (0 = none) [default: 0] |
--priority <PRIORITY> | Higher = scheduled first within FIFO bucket [default: 0] |
--gpu-type <GPU_TYPE> | Pin accelerator label (e.g. 'nvidia-l4') [default: ""] |
--vram-gb <VRAM_GB> | Caller-declared VRAM (GB) [default: 0] |
--machine-type <MACHINE_TYPE> | Pin machine type verbatim [default: ""] |
--pinned-host <PINNED_HOST> | Hard-pin every scheduled job to one registry target or consumer id [default: ""] |
--repo <REPO> | Git URL to clone before running [default: ""] |
--repo-ref <REPO_REF> | Exact full lowercase commit to fetch; required with --repo [default: ""] |
--repo-workdir <REPO_WORKDIR> | Override cloned-repo dir [default: ""] |
--repo-extras <REPO_EXTRAS> | pip extras on the clone [default: train] |
--pre-command <PRE_COMMAND> | Shell snippet placed before the command in the same shell [default: ""] |
--apt <APT> | Comma-separated apt packages [default: ""] |
--output-uri <OUTPUT_URI> | Additional provider-neutral `stado://` output destination [default: ""] |
--verify <VERIFY> | Command that must exit 0 after success (reverses to FAILED otherwise) [default: ""] |
--exclusive | Claim the whole GPU |
--secret-env <SECRET_ENV> | Scoped workload secret as ENV_NAME=SKARBIEC_ITEM#FIELD |
--overlap-policy <OVERLAP_POLICY> | skip (default): don't fire while the prior instance is still queued/running. allow: fire regardless [default: skip] [possible values: skip, allow] |
--disabled | Create the schedule paused (enable later with `schedule resume`) |
Output and state effect
It performs the operation described above and emits its operator result on standard output or standard error. Any state change is limited to the resources and records named by the purpose and options on this page.
Refusals
- Exact full lowercase commit to fetch; required with --repo [default: ""]
- Command that must exit 0 after success (reverses to FAILED otherwise) [default: ""]
- Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.