Reference ยป Primitives

App

An App is a logical container for Primitives that are updated together through transactional deployments.

Definition

An App is defined by a single convox.yml

resources:
  database:
    type: postgres
services:
  web:
    build: .
    resources:
      - database

Command Line Interface

Creating an App

$ convox apps create myapp
Creating myapp... OK

Getting information about an App

$ convox apps info myapp
Name    myapp
Status  running
Locked  false
Release RABCDEFGHI
Router  router.0a1b2c3d4e5f.convox.cloud

Listing Apps

$ convox apps
APP    STATUS   RELEASE
myapp  running  RABCDEFGHI

Deleting an App

$ convox apps delete myapp
Deleting myapp... OK

Getting logs for an App

$ convox logs -a myapp
2000-01-01T00:00:00 service/web/web-zyxwv Starting myapp on port 5000

Cancelling a deployment that is in progress

$ convox apps cancel myapp
Cancelling deployment of myapp... OK

Preventing accidental deletion of an App

$ convox apps lock myapp
Locking myapp... OK

$ convox apps unlock myapp
Unlocking myapp... OK

Exporting an App

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

Importing an App

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