Skip to content

manage-application.rst

Latest commit

 

History

History
133 lines (104 loc) · 5.67 KB

manage-application.rst

File metadata and controls

133 lines (104 loc) · 5.67 KB
title:Manage an Application on Deis
description:First steps for developers using Deis to deploy and scale applications.

Manage an Application

Deis includes many tools that help you configure, scale, adminster and troubleshoot your deployed :ref:`Application`.

Configure the Application

Use deis config to set a DATABASE_URL that attaches the application to an external PostgreSQL database.

$ deis config:set DATABASE_URL=postgres://user:pass@example.com:5432/db
=== peachy-waxworks
JAVA_OPTS: -Xmx384m -Xss512k -XX:+UseCompressedOops
PATH: /app/.jdk/bin:/usr/local/bin:/usr/bin:/bin
MAVEN_OPTS: -Xmx384m -Xss512k -XX:+UseCompressedOops
DATABASE_URL: postgres://user:pass@example.com:5432/db

Applications deployed on Deis store config in environment variables. Backing services like databases, caches and queues are decoupled from the application and attached with environment variables.

Scale the Application

Use deis scale to control the number of :ref:`Containers <container>` that power your app.

$ deis scale web=8
Scaling containers... but first, coffee!
done in 20s

=== peachy-waxworks Containers

--- web: `java -cp target/classes:target/dependency/* HelloWorld`
web.1 up 2013-12-03T00:00:25.836Z (dev-runtime-1)
web.2 up 2013-12-03T00:30:10.934Z (dev-runtime-1)
web.3 up 2013-12-03T00:30:10.950Z (dev-runtime-1)
web.4 up 2013-12-03T00:30:10.963Z (dev-runtime-1)
web.5 up 2013-12-03T00:30:10.978Z (dev-runtime-1)
web.6 up 2013-12-03T00:30:10.993Z (dev-runtime-1)
web.7 up 2013-12-03T00:30:11.010Z (dev-runtime-1)
web.8 up 2013-12-03T00:30:11.027Z (dev-runtime-1)

Applications deployed on Deis scale out via the process model. Web requests are automatically routed to the web processes defined by your application.

You must define process types like web or worker in a Procfile in the root of your application repository.

Administer the Application

Use deis run to execute commands against the deployed version of your application.

$ deis run ls -l
total 28
-rw-r--r-- 1 root root  553 Dec  2 23:59 LICENSE
-rw-r--r-- 1 root root   60 Dec  2 23:59 Procfile
-rw-r--r-- 1 root root   33 Dec  2 23:59 README.md
-rw-r--r-- 1 root root 1622 Dec  2 23:59 pom.xml
drwxr-xr-x 3 root root 4096 Dec  2 23:59 src
-rw-r--r-- 1 root root   25 Dec  2 23:59 system.properties
drwxr-xr-x 6 root root 4096 Dec  3 00:00 target

Applications deployed on Deis use one-off processes for admin tasks like database migrations and other tasks that must run against the live application.

Share the Application

Use deis sharing:add to allow another Deis user to collaborate on your application.

$ deis sharing:add otheruser
Adding otheruser to peachy-waxworks collaborators... done

Use deis sharing to see who an application is currently shared with, and deis sharing:remove to remove a collaborator.

Note

Collaborators can do anything with an application that its owner can do, except delete the application itself.

When working with an application that has been shared with you, clone the original repository and add Deis' git remote entry before attempting to git push any changes to Deis.

$ git clone https://github.com/opdemand/example-java-jetty.git
Cloning into 'example-java-jetty'... done
$ cd example-java-jetty
$ git remote add -f deis git@local.deisapp.com:peachy-waxworks.git
Updating deis
From deis-controller.local:peachy-waxworks
 * [new branch]      master     -> deis/master

Troubleshoot the Application

Use deis logs to view the log output from your deployed application.

$ deis logs | tail
Dec  3 00:30:31 ip-10-250-15-201 peachy-waxworks[web.5]: INFO:oejsh.ContextHandler:started o.e.j.s.ServletContextHandler{/,null}
Dec  3 00:30:31 ip-10-250-15-201 peachy-waxworks[web.8]: INFO:oejs.Server:jetty-7.6.0.v20120127
Dec  3 00:30:31 ip-10-250-15-201 peachy-waxworks[web.5]: INFO:oejs.AbstractConnector:Started SelectChannelConnector@0.0.0.0:10005
Dec  3 00:30:31 ip-10-250-15-201 peachy-waxworks[web.6]: INFO:oejsh.ContextHandler:started o.e.j.s.ServletContextHandler{/,null}
Dec  3 00:30:31 ip-10-250-15-201 peachy-waxworks[web.7]: INFO:oejsh.ContextHandler:started o.e.j.s.ServletContextHandler{/,null}
Dec  3 00:30:31 ip-10-250-15-201 peachy-waxworks[web.6]: INFO:oejs.AbstractConnector:Started SelectChannelConnector@0.0.0.0:10006
Dec  3 00:30:31 ip-10-250-15-201 peachy-waxworks[web.8]: INFO:oejsh.ContextHandler:started o.e.j.s.ServletContextHandler{/,null}
Dec  3 00:30:31 ip-10-250-15-201 peachy-waxworks[web.7]: INFO:oejs.AbstractConnector:Started SelectChannelConnector@0.0.0.0:10007
Dec  3 00:30:31 ip-10-250-15-201 peachy-waxworks[web.8]: INFO:oejs.AbstractConnector:Started SelectChannelConnector@0.0.0.0:10008

Applications deployed on Deis treat logs as event streams. Deis aggregates stdout and stderr from every :ref:`Container` making it easy to troubleshoot problems with your application.