:title: Deploying with Dockerfiles on Deis
:description: How to deploy applications on Deis using Dockerfiles

.. _using-dockerfiles:

Using Dockerfiles
=================
Deis supports deploying applications via Dockerfiles.  A `Dockerfile`_ automates the steps for crafting a `Docker Image`_.
Dockerfiles are incredibly powerful but require some extra work to define your exact application runtime environment.

Prepare an Application
----------------------
If you do not have an existing application, you can clone an example application that demonstrates the Dockerfile workflow.

.. code-block:: console

    $ git clone https://github.com/deis/helloworld.git
    $ cd helloworld

Dockerfile Requirements
^^^^^^^^^^^^^^^^^^^^^^^
In order to deploy Dockerfile applications, they must conform to the following requirements:

 * The Dockerfile must EXPOSE only one port
 * The exposed port must be an HTTP service that can be connected to an HTTP router
 * A default CMD must be specified for running the container

.. note::

    Dockerfiles which expose more than one port will hit `issue 1156`_.

.. attention::

    Support for non-HTTP services is coming soon

Create an Application
---------------------
Use ``deis create`` to create an application on the :ref:`controller`.

.. code-block:: console

    $ deis create
    Creating application... done, created folksy-offshoot
    Git remote deis added

Push to Deploy
--------------
Use ``git push deis master`` to deploy your application.

.. code-block:: console

    $ git push deis master
    Counting objects: 13, done.
    Delta compression using up to 8 threads.
    Compressing objects: 100% (13/13), done.
    Writing objects: 100% (13/13), 1.99 KiB | 0 bytes/s, done.
    Total 13 (delta 2), reused 0 (delta 0)
    -----> Building Docker image
    Uploading context 4.096 kB
    Uploading context
    Step 0 : FROM deis/base:latest
     ---> 60024338bc63
    Step 1 : MAINTAINER OpDemand <info@opdemand.com>
     ---> Using cache
     ---> 2af5ad7f28d6
    Step 2 : RUN wget -O /tmp/go1.2.1.linux-amd64.tar.gz -q https://go.googlecode.com/files/go1.2.1.linux-amd64.tar.gz
     ---> Using cache
     ---> cf9ef8c5caa7
    Step 3 : RUN tar -C /usr/local -xzf /tmp/go1.2.1.linux-amd64.tar.gz
     ---> Using cache
     ---> 515b1faf3bd8
    Step 4 : RUN mkdir -p /go
     ---> Using cache
     ---> ebf4927a00e9
    Step 5 : ENV GOPATH /go
     ---> Using cache
     ---> c6a276eded37
    Step 6 : ENV PATH /usr/local/go/bin:/go/bin:$PATH
     ---> Using cache
     ---> 2ba6f6c9f108
    Step 7 : ADD . /go/src/github.com/deis/helloworld
     ---> 94ab7f4b977b
    Removing intermediate container 171b7d9fdb34
    Step 8 : RUN cd /go/src/github.com/deis/helloworld && go install -v .
     ---> Running in 0c8fbb2d2812
    github.com/deis/helloworld
     ---> 13b5af931393
    Removing intermediate container 0c8fbb2d2812
    Step 9 : ENV PORT 80
     ---> Running in 9b07da36a272
     ---> 2dce83167874
    Removing intermediate container 9b07da36a272
    Step 10 : CMD ["/go/bin/helloworld"]
     ---> Running in f7b215199940
     ---> b1e55ce5195a
    Removing intermediate container f7b215199940
    Step 11 : EXPOSE 80
     ---> Running in 7eb8ec45dcb0
     ---> ea1a8cc93ca3
    Removing intermediate container 7eb8ec45dcb0
    Successfully built ea1a8cc93ca3
    -----> Pushing image to private registry

           Launching... done, v2

    -----> folksy-offshoot deployed to Deis
           http://folksy-offshoot.local.deisapp.com

           To learn more, use `deis help` or visit http://deis.io

    To ssh://git@local.deisapp.com:2222/folksy-offshoot.git
     * [new branch]      master -> master

    $ curl -s http://folksy-offshoot.local.deisapp.com
    Welcome to Deis!
    See the documentation at http://docs.deis.io/ for more information.

Because a Dockerfile application is detected, the ``cmd`` process type is automatically scaled to 1 on first deploy.

Define Process Types
--------------------
Docker containers have a default command usually specified by a `CMD instruction`_.
Deis uses the ``cmd`` process type to refer to this default command.

Deis also supports scaling other process types as defined in a `Procfile`_.  To use this functionality, you must:

1. Define process types with a `Procfile`_ in the root of your repository
2. Include a ``start`` executable that can be called with: ``start <process-type>``


.. _`Dockerfile`: http://docs.docker.io/en/latest/use/builder/
.. _`Docker Image`: http://docs.docker.io/introduction/understanding-docker/
.. _`CMD instruction`: http://docs.docker.io/reference/builder/#cmd
.. _`issue 1156`: https://github.com/deis/deis/issues/1156
.. _`Procfile`: https://devcenter.heroku.com/articles/procfile