Skip to content

rackspace.rst

Latest commit

 

History

History
136 lines (86 loc) · 4 KB

rackspace.rst

File metadata and controls

136 lines (86 loc) · 4 KB
title:Installing Deis on Rackspace
description:How to provision a multi-node Deis cluster on Rackspace

Rackspace

We'll mostly be following the CoreOS on Rackspace guide. You'll need to have a sane python environment with pip already installed (sudo easy_install pip).

Please :ref:`get the source <get_the_source>` and refer to the scripts in contrib/rackspace while following this documentation.

Install supernova

$ sudo pip install keyring
$ sudo pip install rackspace-novaclient
$ sudo pip install supernova

Configure supernova

Edit ~/.supernova to match the following:

[production]
OS_AUTH_URL = https://identity.api.rackspacecloud.com/v2.0/
OS_USERNAME = {rackspace_username}
OS_PASSWORD = {rackspace_api_key}
OS_TENANT_NAME = {rackspace_account_id}
OS_REGION_NAME = DFW (or ORD or another region)
OS_AUTH_SYSTEM = rackspace

Your account ID is displayed in the upper right-hand corner of the cloud control panel UI, and your API key can be found on the Account Settings page.

Generate SSH Key

Set up your keys

Tell supernova about the key pair and give it an identifiable name:

$ supernova production keypair-add --pub-key ~/.ssh/deis.pub deis-key

Generate a New Discovery URL

Choose number of instances

By default, the provision script will provision 3 servers. You can override this by setting DEIS_NUM_INSTANCES:

$ DEIS_NUM_INSTANCES=5 ./provision-rackspace-cluster.sh deis-key

Note that for scheduling to work properly, clusters must consist of at least 3 nodes and always have an odd number of members. For more information, see optimal etcd cluster size.

Deis clusters of less than 3 nodes are unsupported.

Run the Provision Script

Run the Rackspace provision script to spawn a new CoreOS cluster. You'll need to provide the name of the key pair you just added. Optionally, you can also specify a flavor name, as well as the supernova environment to use. The environment will default to production, and the flavor to performance1-2.

$ cd contrib/rackspace
$ ./provision-rackspace-cluster.sh
Usage: provision-rackspace-cluster.sh <key pair name> [flavor] [environment]
$ ./provision-rackspace-cluster.sh deis-key

Note

The provision script will by default provision performance1-2 servers. Choosing a smaller server size is not recommended. Please refer to :ref:`system-requirements` for resource considerations when choosing a server size to run Deis.

Configure DNS

See :ref:`configure-dns` for more information on properly setting up your DNS records with Deis.

Configure Load Balancer

You'll need to create two load balancers on Rackspace to handle your cluster:

Load Balancer 1
Port 80
Protocol HTTP
Health Monitoring -
  Monitor Type HTTP
  HTTP Path /health-check

Load Balancer 2
Virtual IP Shared VIP on Another Load Balancer (select Load Balancer 1)
Port 2222
Protocol TCP

Install Deis Platform

Now that you've finished provisioning a cluster, please refer to :ref:`install_deis_platform` to start installing the platform.