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

     1  :title: Quick Start
     2  :description: How to start provisioning a multi-node Deis cluster
     3  
     4  Quick Start
     5  ===========
     6  
     7  These steps will help you provision a Deis cluster.
     8  
     9  
    10  .. _generate_ssh_key:
    11  
    12  Generate an SSH key
    13  -------------------
    14  
    15  The ``deisctl`` utility communicates with remote machines over an SSH tunnel.
    16  If you don't already have an SSH key, the following command will generate
    17  a new keypair named "deis":
    18  
    19  .. code-block:: console
    20  
    21      $ ssh-keygen -q -t rsa -f ~/.ssh/deis -N '' -C deis
    22  
    23  
    24  .. _generate_discovery_url:
    25  
    26  Generate a New Discovery URL
    27  ----------------------------
    28  
    29  Discovery URLs help connect `etcd`_ instances together by storing a list of peer addresses and metadata under a
    30  unique address. You can generate a new discovery URL for use in your platform by
    31  running the following from the root of the repository:
    32  
    33  .. code-block:: console
    34  
    35      $ make discovery-url
    36  
    37  This will write a new discovery URL to the user-data file. Some essential scripts are supplied in
    38  this user-data file, so it is mandatory for provisioning Deis.
    39  
    40  Check System Requirements
    41  -------------------------
    42  
    43  The Deis provision scripts default to a machine size which should be adequate to run Deis, but this
    44  can be customized. Please refer to :ref:`system-requirements` for resource considerations when
    45  choosing a machine size to run Deis.
    46  
    47  Choose a Provider
    48  -----------------
    49  
    50  Choose one of the following providers and deploy a new cluster:
    51  
    52  - :ref:`deis_on_aws`
    53  - :ref:`deis_on_digitalocean`
    54  - :ref:`deis_on_gce`
    55  - :ref:`deis_on_rackspace`
    56  - :ref:`deis_on_vagrant`
    57  - :ref:`deis_on_bare_metal`
    58  
    59  
    60  Configure DNS
    61  -------------
    62  
    63  See :ref:`configure-dns` for more information on properly setting up your DNS records with Deis.
    64  
    65  
    66  Install Deis Platform
    67  ---------------------
    68  
    69  Now that you've finished provisioning a CoreOS cluster,
    70  please refer to :ref:`install_deisctl` and :ref:`install_deis_platform`.
    71  
    72  
    73  .. _`CoreOS`: https://coreos.com/
    74  .. _`etcd`: https://github.com/coreos/etcd