apps

apps

List apps

Usage

    convox apps

Examples

    $ convox apps
    APP          STATUS   RELEASE
    myapp        running  RABCDEFGHI
    myapp2       running  RIHGFEDCBA

apps cancel

Cancel an app update

Usage

    convox apps cancel [app]

Examples

    $ convox apps cancel
    Cancelling deployment of myapp...
    Rewriting last active release...
    OK

convox apps cancel cancels a deploy that is in progress and rolls the App back to the Release it was running before. It returns app is not updating when no deploy is running, including while a failed deploy is already rolling back. After the cancel, the CLI creates a new Release with the same build, environment and description as the App's most recent Release, without promoting it. It does not affect Builds. To cancel a Build the Rack is still running, use convox builds cancel.

apps create

Create an app

Usage

    convox apps create [app]

Examples

    $ convox apps create myapp
    Creating myapp... OK

apps delete

Delete an app

Usage

    convox apps delete <app>

Examples

    $ convox apps delete myapp
    Deleting myapp... OK

apps export

Export an app

Usage

    convox apps export [app]

Flags

Flag	Short	Description
--file	-f	Export to file

Examples

    $ convox apps export --file myapp.tgz
    Exporting app myapp... OK
    Exporting env... OK
    Exporting build BABCDEFGHI... OK
    Exporting resource database... OK
    Packaging export... OK

apps import

Import an app

Usage

    convox apps import [app]

Flags

Flag	Short	Description
--file	-f	Import from file

Examples

    $ convox apps import myapp2 --file myapp.tgz
    Creating app myapp2... OK
    Importing build... OK, RIHGFEDCBA
    Importing env... OK, RJIHGFEDCB
    Promoting RJIHGFEDCB... OK
    Importing resource database... OK

apps info

Get information about an app

Usage

    convox apps info [app]

Examples

    $ convox apps info
    Name        myapp
    Status      running
    Generation  3
    Locked      false
    Release     RABCDEFGHI

apps lock

Enable termination protection

Usage

    convox apps lock [app]

Examples

    $ convox apps lock
    Locking myapp... OK

apps params

Display app parameters

Usage

    convox apps params [app]

Examples

    $ convox apps params -a myapp
    BuildCpu     1000
    BuildMem     4096

Only parameters that are set are listed. A parameter you have not set does not appear.

apps params set

Set app parameters

Usage

    convox apps params set <Key=Value> [Key=Value]...

Examples

    $ convox apps params set BuildCpu=1000 BuildMem=4096 -a myapp
    Updating parameters...
    ...
    OK

The App is selected with -a. Setting a parameter re-promotes the App's current Release, so the command streams that rollout and prints OK once the App is running again.

apps unlock

Disable termination protection

Usage

    convox apps unlock [app]

Examples

    $ convox apps unlock
    Unlocking myapp... OK

See Also

• App for app primitives
• App Parameters for available app parameters
• Deploy for deploying apps