github.com/rvaralda/deis@v1.4.1/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.4.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  .. note::
    30  
    31      For Vagrant clusters: ``ssh-add ~/.vagrant.d/insecure_private_key``
    32  
    33  Find the public IP address of one of your nodes, and export it to the DEISCTL_TUNNEL environment
    34  variable (substituting your own IP address):
    35  
    36  .. code-block:: console
    37  
    38      $ export DEISCTL_TUNNEL=104.131.93.162
    39  
    40  If you set up the "convenience" DNS records, you can just refer to them via
    41  
    42  .. code-block:: console
    43  
    44      $ export DEISCTL_TUNNEL="deis-1.example.com"
    45  
    46  .. note::
    47  
    48      For Vagrant clusters: ``export DEISCTL_TUNNEL=172.17.8.100``
    49  
    50  This is the IP address where deisctl will attempt to communicate with the cluster. You can test
    51  that it is working properly by running ``deisctl list``. If you see a single line of output, the
    52  control utility is communicating with the nodes.
    53  
    54  Before provisioning the platform, we'll need to add the SSH key to Deis so it can connect to remote
    55  hosts during ``deis run``:
    56  
    57  .. code-block:: console
    58  
    59      $ deisctl config platform set sshPrivateKey=~/.ssh/deis
    60  
    61  We'll also need to tell the controller which domain name we are deploying applications under:
    62  
    63  .. code-block:: console
    64  
    65      $ deisctl config platform set domain=example.com
    66  
    67  .. note::
    68  
    69      For Vagrant clusters: ``deisctl config platform set domain=local3.deisapp.com``
    70  
    71  Once finished, run this command to provision the Deis platform:
    72  
    73  .. code-block:: console
    74  
    75      $ deisctl install platform
    76  
    77  You will see output like the following, which indicates that the units required to run Deis have
    78  been loaded on the CoreOS cluster:
    79  
    80  .. code-block:: console
    81  
    82      ● ▴ ■
    83      ■ ● ▴ Installing Deis...
    84      ▴ ■ ●
    85  
    86      Scheduling data containers...
    87      ...
    88      Deis installed.
    89      Please run `deisctl start platform` to boot up Deis.
    90  
    91  Run this command to start the Deis platform:
    92  
    93  .. code-block:: console
    94  
    95      $ deisctl start platform
    96  
    97  Once you see "Deis started.", your Deis platform is running on a cluster! You may verify that all
    98  of the Deis units are loaded and active by running the following command:
    99  
   100  .. code-block:: console
   101  
   102      $ deisctl list
   103  
   104  All of the units should be active.
   105  
   106  Now that you've finished provisioning a cluster, please refer to :ref:`using_deis` to get started
   107  using the platform.