drove apps¶

Manage the lifecycle of your applications.

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 in the cluster.

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

Option	Description
`-s, --sort`	Sort output by column (0-8)
`-r, --reverse`	Sort in reverse order

drove apps summary¶

Show the details of one application.

drove apps summary <app-id>

Example:

drove apps summary PAYMENT_SERVICE-1

drove apps spec¶

Print the raw JSON specification of an application.

drove apps spec <app-id>

drove apps create¶

Create a new application from a spec file.

drove apps create <spec-file>

Example:

drove apps create payment-service.json

The app starts 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 an application to an exact instance count. The command 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 of an application (scale to 0).

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

drove apps restart¶

Restart all instances, one at a time, in a rolling fashion.

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. The app must have zero instances before you can destroy it.

drove apps destroy <app-id>

drove apps cancelop¶

Cancel the operation that is currently running on an application.

drove apps cancelop <app-id>