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). update is a full-spec replacement — every field is required (the create spec minus name), not a merge-patch. For anything beyond the simple path, 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 (full-spec replacement)
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