github.com/greenboxal/deis@v1.12.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.12.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  .. note::
    62  
    63      For Vagrant clusters: ``deisctl config platform set sshPrivateKey=${HOME}/.vagrant.d/insecure_private_key``
    64  
    65  We'll also need to tell the controller which domain name we are deploying applications under:
    66  
    67  .. code-block:: console
    68  
    69      $ deisctl config platform set domain=example.com
    70  
    71  .. note::
    72  
    73      For Vagrant clusters: ``deisctl config platform set domain=local3.deisapp.com``
    74  
    75  Once finished, run this command to provision the Deis platform:
    76  
    77  .. code-block:: console
    78  
    79      $ deisctl install platform
    80  
    81  You will see output like the following, which indicates that the units required to run Deis have
    82  been loaded on the CoreOS cluster:
    83  
    84  .. code-block:: console
    85  
    86      ● ▴ ■
    87      ■ ● ▴ Installing Deis...
    88      ▴ ■ ●
    89  
    90      Scheduling data containers...
    91      ...
    92      Deis installed.
    93      Please run `deisctl start platform` to boot up Deis.
    94  
    95  Run this command to start the Deis platform:
    96  
    97  .. code-block:: console
    98  
    99      $ deisctl start platform
   100  
   101  Once you see "Deis started.", your Deis platform is running on a cluster! You may verify that all
   102  of the Deis units are loaded and active by running the following command:
   103  
   104  .. code-block:: console
   105  
   106      $ deisctl list
   107  
   108  All of the units should be active.
   109  
   110  Now that you've finished provisioning a cluster, please refer to :ref:`using_deis` to get started
   111  using the platform.