formation.rst

title:	Formation
description:	A Deis formation is a set of infrastructure used to host applications.
keywords:	formation, deis

Formation

A :ref:`formation` is a set of infrastructure used to host :ref:`Applications <application>`. Each formation includes :ref:`Layers <layer>` of :ref:`Nodes <node>` that provide different services to the formation.

Creating a Formation

Creating a formation is easy...

$ deis formations:create test
Creating formation... done, created test

Viewing a Formation

We can take a peek at our new formation using "deis formations:info":

$ deis formations:info test
=== test Formation
{
  "updated": "2013-11-26T22:43:37.854Z",
  "uuid": "6955c2a8-8505-413b-90b2-305daebdbbf9",
  "created": "2013-11-26T22:43:37.854Z",
  "domain": null,
  "owner": "gabrtv",
  "nodes": "{}",
  "id": "test"
}

=== test Layers

=== test Nodes

This formation has no :ref:`Layers <layer>` and no :ref:`Nodes <node>` -- so it can't do much yet. It's also important to note that "domain" is null. Without a domain a formation can only host one application at a time.

Updating a Formation

We can update the formation with "deis formations:update". Let's give our formation a "domain" so we can have it host multiple applications later once we scale some proxy nodes and setup wildcard DNS.

$ deis formations:update test --domain=deisapp.com
{
  "updated": "2013-11-26T22:54:46.708Z",
  "uuid": "6955c2a8-8505-413b-90b2-305daebdbbf9",
  "created": "2013-11-26T22:43:37.854Z",
  "domain": "deisapp.com",
  "owner": "gabrtv",
  "nodes": "{}",
  "id": "test"
}