Version 1

This documentation is for Deis Workflow (v1). For v2 documentation visit https://github.com/deis/workflow.

Concepts

Deis is a lightweight application platform that deploys and scales Twelve-Factor apps as Docker containers across a cluster of CoreOS machines.

Twelve-Factor

The Twelve-Factor App is a methodology for building modern applications that can be scaled across a distributed system.

We consider it an invaluable synthesis of much experience with software-as-a-service apps in the wild, especially on the Heroku platform.

Deis is designed to run applications that adhere to Twelve-Factor App methodology and best practices.

Docker

Docker is an open source project to pack, ship and run any application as a lightweight, portable, self-sufficient container.

Deis curates your applications as Docker images, which are then distributed across your cluster as Docker containers.

(Deis itself is also a set of coordinated Docker containers.)

CoreOS

CoreOS is a new, minimal Linux distribution, rearchitected for running modern, containerized infrastructure stacks.

Deis runs on CoreOS machines that can be hosted anywhere – public cloud, private cloud, bare metal or even your workstation.

CoreOS allows Deis to host applications and services at scale with high resilience, in a way that is simple to operate.

Applications

Deis is designed around the concept of an Application, or app. Applications live on a cluster where they use Containers to service requests.

Developers use applications to push code, change configuration, scale processes, view logs, run admin commands and much more.

Build, Release, Run

Deis Git Push Workflow

Build Stage

The Builder processes incoming git push requests and builds applications inside ephemeral Docker containers, resulting in a new Docker image.

Release Stage

During the release stage, a Build is combined with Config to create a new numbered Release. This release is then pushed to a Docker registry for later execution. The release stage is triggered any time a new build is created or config is changed, making it easy to rollback code and configuration changes.

Run Stage

The run stage dispatches containers to a scheduler and updates the router accordingly. The scheduler is in control of placing containers on hosts and balancing them evenly across the cluster. Containers are published to the router once they are healthy. Old containers are only collected after the new containers are live and serving traffic – providing zero-downtime deploys.

Backing Services

Deis treats databases, caches, storage, messaging systems, and other backing services as attached resources, in keeping with Twelve-Factor best practices.

Applications are attached to backing services using environment variables. Because applications are decoupled from backing services, apps are free to scale up independently, to swap services provided by other apps, or to switch to external or third-party vendor services.