anycloud submit

Deploy a finite container Job. Alias: anycloud run.

anycloud submit <image> [-- command...] [options]

Use -- before a container command that has its own flags.

Options

Option	Description
-i, --id ID	Custom deployment ID
-e, --env KEY=VALUE	Environment value; repeatable. -e KEY reads the current shell
--env-file FILE	Load values from a dotenv file
--secret NAME	Inject a named Secret; repeatable
-p, --persist	Keep the VM after the Job exits
--persist-bucket	Retain the automatic spot checkpoint Bucket
--credentials NAME	Pin compute to one saved credential
--region REGION	Pin one compute region
--vm-type TYPE	Exact VM; repeat for an ordered fallback pool
--gpu-type TYPE	GPU model and optional count; repeat for an ordered fallback pool
--spot	Use spot/preemptible capacity
--local	Use the API server's Local compute capability
--disk-size GB	Root disk capacity
--disk-tier TIER	medium, high, or ultra
--zone ZONE	Availability zone
--input-bucket NAME	Read-only input at /mnt/input
--output-bucket NAME	Writable output at /mnt/output
--input-storage-credentials NAME	Cross-account input identity
--input-storage-region REGION	Cross-account input Bucket region
--output-storage-credentials NAME	Cross-account output identity
--output-storage-region REGION	Cross-account output Bucket region
--checkpoint-storage-credentials NAME	Cross-account checkpoint identity
--checkpoint-storage-region REGION	Cross-account checkpoint Bucket region
--gpus VALUE	Docker GPU exposure: all or a count
--shm-size SIZE	Shared memory, such as 8g
--memory LIMIT	Container memory limit
--cpus COUNT	Container CPU limit
--runtime RUNTIME	Docker runtime
--ipc MODE	host, private, or shareable
--ulimit VALUE	Docker ulimit; repeatable
--bind BIND...	Host bind mounts

--gpu-type and --vm-type are mutually exclusive. --credentials may appear once; omit it to use eligible saved named credentials. An unpinned credential pool requires an unpinned region.

--persist-bucket only applies to spot Jobs. On non-spot submissions, the CLI warns and ignores it. It is independent of --persist.

--local requires starting the API with Local Docker enabled:

anycloud api start --enable-local-docker
anycloud submit IMAGE --local

Examples

anycloud submit ghcr.io/acme/train:latest \
  --credentials my-aws \
  --gpu-type h100:8 \
  --spot \
  --gpus all \
  -- python train.py --epochs 10

anycloud submit ghcr.io/acme/app:latest \
  --credentials my-aws \
  --vm-type t3.medium

GITHUB_TOKEN supplies GitHub authentication in non-interactive use. ANYCLOUD_CREDENTIALS_NAME is the credentials-name fallback when the flag is absent.

For field precedence and constraints, see Configuration.