Skip to content

Commit 4b3b8f5

Browse files
author
Matthew Fisher
committed
docs(using_deis): explain difference between web and cmd
Also states that Deis does not automatically migrate from web to cmd process types when switching contexts.
1 parent aaa2f8e commit 4b3b8f5

1 file changed

Lines changed: 15 additions & 0 deletions

File tree

docs/using_deis/process-types.rst

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -92,4 +92,19 @@ Use ``deis scale web=3`` to increase ``web`` processes to 3, for example. Scalin
9292
process type directly changes the number of :ref:`Containers <container>`
9393
running that process.
9494

95+
Web vs Cmd Process Types
96+
------------------------
97+
98+
When deploying to Deis using a Heroku Buildpack, Deis boots the ``web`` process type to boot the
99+
application server. When you deploy an application that has a Dockerfile or uses :ref:`Docker
100+
images <using-docker-images>`, Deis boots the ``cmd`` process type. Both act similarly in that they
101+
are exposed to the router as web applications. However, The ``cmd`` process type is special because
102+
it is equivalent to running the :ref:`container` without any additional arguments. Every other
103+
process type is equivalent to running the relevant command that is provided in the Procfile.
104+
105+
When migrating from Heroku Buildpacks to a Docker-based deployment, Deis will not convert ``web``
106+
process types to ``cmd``. To do this, you'll have to manually scale down the old process type and
107+
scale the new process type up.
108+
109+
95110
.. _`process model`: https://devcenter.heroku.com/articles/process-model

0 commit comments

Comments
 (0)