Skip to content
Docs

inquir apps replicas

Show the replicas of a stateful application, rebuild one or delete its retained volumes.

@inquir/compute-cliv0.4.4 · Node.js 22+

Usage#

inquir apps replicasbash
inquir apps replicas <app> [options]
inquir apps replicas rebuild <app> <n> [--reason <text>] [--yes]
inquir apps replicas delete-volume <app> <n> [--yes]

Options#

OptionDescription
--reason <text>Why the replica is rebuilt; recorded with the request.
--yes, -yConfirm this operation without prompting.
--jsonPrint machine-readable results.

Global flags, environments and CLI credentials ↗

Examples#

Example 1bash
inquir apps replicas db
Example 2bash
inquir apps replicas rebuild db 2 --reason "disk errors"
Example 3bash
inquir apps replicas delete-volume db 2

Behavior#

Alpha. For each ordinal (db-0, db-1, …) the list shows its server, location, volume generation, release, role and state. A stateless application is reported as such.

rebuild starts ordinal n on another server with a new, empty volume; runtime.hooks.init or the image restores the data, and the old volume is kept for the retention period. delete-volume deletes the retained volumes of ordinal n for good. Both ask for confirmation unless --yes is given.

Guides#