github.com/misfo/deis@v1.0.1-0.20141111224634-e0eee0392b8a/docs/installing_deis/install-platform.rst (about)

     1  :title: Installing the Deis Platform
     2  :description: Learn how to install the Deis Platform
     3  
     4  .. _install_deis_platform:
     5  
     6  Install the Deis Platform
     7  =========================
     8  
     9  .. important::
    10  
    11      Before installing the platform, please see :ref:`install_deisctl`.
    12  
    13  From the computer you installed the Deis Control Utility, we will provision the Deis platform.
    14  Ensure your SSH agent is running and select the private key that corresponds to the SSH key added
    15  to your CoreOS nodes:
    16  
    17  .. code-block:: console
    18  
    19      $ eval `ssh-agent -s`
    20      $ ssh-add ~/.ssh/deis
    21  
    22  Find the public IP address of one of your nodes, and export it to the DEISCTL_TUNNEL environment
    23  variable (substituting your own IP address):
    24  
    25  .. code-block:: console
    26  
    27      $ export DEISCTL_TUNNEL=104.131.93.162
    28  
    29  If you set up the "convenience" DNS records, you can just refer to them via
    30  
    31  .. code-block:: console
    32  
    33      $ export DEISCTL_TUNNEL="deis-1.example.com"
    34  
    35  This is the IP address where deisctl will attempt to communicate with the cluster. You can test
    36  that it is working properly by running ``deisctl list``. If you see a single line of output, the
    37  control utility is communicating with the nodes.
    38  
    39  Before provisioning the platform, we'll need to add the SSH key to Deis so it can connect to remote
    40  hosts during ``deis run``:
    41  
    42  .. code-block:: console
    43  
    44      $ deisctl config platform set sshPrivateKey=~/.ssh/deis
    45  
    46  We'll also need to tell the controller which domain name we are deploying applications under:
    47  
    48  .. code-block:: console
    49  
    50      $ deisctl config platform set domain=example.com
    51  
    52  Once finished, run this command to provision the Deis platform:
    53  
    54  .. code-block:: console
    55  
    56      $ deisctl install platform
    57  
    58  You will see output like the following, which indicates that the units required to run Deis have
    59  been loaded on the CoreOS cluster:
    60  
    61  .. code-block:: console
    62  
    63      ● ▴ ■
    64      ■ ● ▴ Installing Deis...
    65      ▴ ■ ●
    66  
    67      Scheduling data containers...
    68      ...
    69      Deis installed.
    70      Please run `deisctl start platform` to boot up Deis.
    71  
    72  Run this command to start the Deis platform:
    73  
    74  .. code-block:: console
    75  
    76      $ deisctl start platform
    77  
    78  Once you see "Deis started.", your Deis platform is running on a cluster! You may verify that all
    79  of the Deis units are loaded and active by running the following command:
    80  
    81  .. code-block:: console
    82  
    83      $ deisctl list
    84  
    85  All of the units should be active.
    86  
    87  Now that you've finished provisioning a cluster, please refer to :ref:`using_deis` to get started
    88  using the platform.