Skip to content

drove apps

Manage application lifecycle.

Synopsis

drove apps <command> [options]

Commands

Command Description
list List applications
summary Show app summary
spec Get app specification
create Create new app
destroy Delete app
deploy Add instances
scale Set instance count
suspend Stop all instances
restart Rolling restart
cancelop Cancel running operation

drove apps list

List all applications.

drove apps list [--sort COLUMN] [--reverse]

drove apps summary

Show application details.

drove apps summary <app-id>

Example:

drove apps summary PAYMENT_SERVICE-1


drove apps spec

Print raw JSON specification.

drove apps spec <app-id>

drove apps create

Create a new application from spec file.

drove apps create <spec-file>

Example:

drove apps create payment-service.json

The app is created in monitoring state. Use deploy or scale to start instances. Refer to Application Lifecycle to understand more about application states.


drove apps deploy

Add new instances to an application.

drove apps deploy <app-id> <count> [--parallelism N] [--timeout DURATION] [--wait]
Option Description Default
-p, --parallelism Concurrent operations 1
-t, --timeout Operation timeout 5m
-w, --wait Wait for completion false

Example:

# Deploy 5 instances, 2 at a time
drove apps deploy PAYMENT_SERVICE-1 5 -p 2 -w


drove apps scale

Scale to exact instance count. Adds or removes instances as needed.

drove apps scale <app-id> <count> [--parallelism N] [--timeout DURATION] [--wait]

Example:

# Scale to 10 instances
drove apps scale PAYMENT_SERVICE-1 10 -w

# Scale down to 2
drove apps scale PAYMENT_SERVICE-1 2 -w


drove apps suspend

Stop all instances (scale to 0).

drove apps suspend <app-id> [--parallelism N] [--timeout DURATION] [--wait]

drove apps restart

Rolling restart of all instances.

drove apps restart <app-id> [--parallelism N] [--timeout DURATION] [--wait]

Example:

# Restart with parallelism of 3
drove apps restart PAYMENT_SERVICE-1 -p 3 -w


drove apps destroy

Delete an application. App must have zero instances.

drove apps destroy <app-id>

drove apps cancelop

Cancel the currently running operation.

drove apps cancelop <app-id>