once run
Run a declared target.
Synopsis#
plaintext
once run [OPTIONS] [TARGET] [ARG]
Description#
Resolves the target id against the workspace graph and executes its run capability through the action cache. Use --remote to ask a compute provider to execute the command.
Arguments#
| Argument | Required | Description |
|---|---|---|
<TARGET> | no | Target id, e.g. examples/hello/hello or ./hello. |
<ARG> | no | Target-kind-specific arguments supplied to the generic run capability. |
Options#
| Flag | Value | Default | Description |
|---|---|---|---|
--sandbox | <SANDBOX> | off | Local filesystem sandbox policy for command actions. |
--config | <KEY=VALUE> | Override the workspace build configuration. See once build --config. | |
--visible | (flag) | Ask graph target kinds to open a visible runtime interface when supported. | |
--runtime-rpc | (flag) | Serve a local JSON-RPC runtime control socket for this run. | |
--runtime-rpc-socket | <RUNTIME_RPC_SOCKET> | Runtime RPC socket path. Defaults to .once/runtime/<session>/control.sock. | |
--remote | (flag) | Run the target's action on a compute provider. | |
--compute | <PROVIDER> | Compute provider used with --remote. Defaults to the configured execution provider. |