Skip to content

runtime

Manage agent runtimes.

grn agentbase runtime <command> [options]

An agent runtime is a deployable container defined by its image, command, args, environment, autoscaling, and flavor. Runtimes converge asynchronously: create/update return as soon as the service accepts the spec (state CREATING/UPDATING) and reach ACTIVE (or ERROR / SERVICE_ACCOUNT_ERROR). Use wait to block until terminal.

Runtimes are addressed by id (the name is immutable after creation). create is fully flag-driven (see create). update is merge-like from the CLI side: fields whose flags are left unset are carried over from the current version (see update); to apply a full spec from a file — or keep the image-auth password out of the shell — generate a template with generate, fill it in, and apply with --file.

Available commands

Command Description
create Create a new agent runtime
generate Print a runtime create template (YAML or JSON)
list List agent runtimes
get Show an agent runtime
update Update an agent runtime (new immutable version)
delete Delete an agent runtime
wait Wait for an agent runtime to reach a terminal state

Sub-resource groups

Group Commands
endpoint list · create · update · delete · start · stop · logs · metrics · events
runtime logs · reset-service-account · versions
trace get · search · tag-values