Coming soon: per-run cost. The summary on stderr says
cost: unknown for now. See Usage and billing for what your sandboxes used.Create a sandbox, run one command in it, print a summary on stderr, and delete
the sandbox (also on error or Ctrl-C). anona-compute exits with the command's exit code;
-i/--stdin streams this terminal's stdin to the command.
Cost is printed when the API reports it; the current API does not, so the
summary says "unknown" rather than guessing.
Exit codes:
0 success
1 general error
2 usage error (bad flag, argument or value)
3 not signed in, or the credential was refused (HTTP 401/403)
4 not found (HTTP 404)
5 plan limit or rate limit (HTTP 429, or error_code plan_limit_exceeded)
exec and run pass the remote command's exit status through unchanged
(0-255; 130 after Ctrl-C) and exit 125 when anona-compute itself failed,
for any of the reasons 1-5 above; their --json error keeps that detailed
code in "cli_code".
Usage
anona-compute run [flags] -- COMMAND [ARGS...]
Flags
| Flag | Type | Description |
|---|---|---|
--allow-out | stringArray | host the sandbox may reach (repeatable); with —no-internet this is the allow-list |
--auto-pause | pause instead of delete when the timeout ends | |
--cmd-timeout | duration | stop waiting for the command after this long (0 = no limit) |
--cwd, -w | string | working directory |
--env, -e | stringArray | environment variable KEY=VALUE for the sandbox (repeatable) |
--help, -h | help for run | |
--idle-pause | string | pause the sandbox after this long with nothing using it (e.g. 15m, 1h); “off” disables it. A duration also makes the timeout pause the sandbox instead of deleting it, as —auto-pause does |
--keep | do not delete the sandbox after the command | |
--metadata | stringArray | metadata KEY=VALUE (repeatable) |
--name | string | a name for the sandbox, shown beside its ID (stored as metadata name=NAME; the ID stays the identifier) |
--network-file | string | JSON egress policy for the sandbox (”-” reads stdin); replaces the flags above |
--no-internet | create the sandbox without internet access | |
--size | string | sandbox size: small (1 vCPU, 2 GiB, 10 GB disk), medium (2, 4 GiB, 20 GB), large (4, 8 GiB, 40 GB) or xl (8, 16 GiB, 80 GB); default: the template’s own size (on Free, the smallest size the template allows) |
--stdin, -i | send this terminal’s stdin to the command (closed at EOF) | |
--template, -t | string | template ID or alias (default: profile default_template, else “base”) |
--timeout | string | sandbox lifetime before it is deleted or paused (e.g. 300s, 1h), or “never” for no time limit (default “300s”) |
--user, -u | string | user to run as (default: the sandbox’s default user) |
--vault-inject | stringArray | inject a vault secret into requests to a host: HOST:HEADER=[bearer:|basic:]SECRET (repeatable) |
--api-key, --api-url, --json, --output, --profile, --request-timeout, --verbose) work on every command; see anona-compute.