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