using-docker-images.rst

title:	Deploying Docker Images on Deis
description:	How to deploy applications on Deis using Docker Images

Using Docker Images

Deis supports deploying applications via an existing Docker Image. This is useful for integrating Deis into Docker-based CI/CD pipelines.

Prepare an Application

Start by cloning an example application:

$ git clone https://github.com/deis/example-go.git
$ cd example-go
$ git checkout docker

Next use your local docker client to build the image and push it to DockerHub.

$ docker build -t <username>/example-go .
$ docker push <username>/example-go

Docker Image Requirements

In order to deploy Docker images, they must conform to the following requirements:

• The Docker image 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

Docker images which expose more than one port will hit issue 1156.

Create an Application

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

$ mkdir -p /tmp/example-go && cd /tmp/example-go
$ deis create
Creating application... done, created example-go

Note

The deis client uses the name of the current directory as the default app name.

Deploy the Application

Use deis pull to deploy your application from DockerHub or a private registry.

$ deis pull gabrtv/example-go:latest
Creating build...  done, v2

$ curl -s http://example-go.local3.deisapp.com
Powered by Deis

Because you are deploying a Docker image, the cmd process type is automatically scaled to 1 on first deploy.

Attention!

Support for Docker registry authentication is coming soon

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.

Process types other than cmd are not supported when using Docker images.