README.md

Provision a Deis Controller on Rackspace

1. Install knife-rackspace with gem install knife-rackspace or just bundle install from the root directory of your deis repository:

   $ cd $HOME/projects/deis
   $ gem install knife-rackspace
   Fetching: knife-rackspace-0.8.1.gem (100%)
   Successfully installed knife-rackspace-0.8.1
   1 gem installed
   Installing ri documentation for knife-rackspace-0.8.1...
   Installing RDoc documentation for knife-rackspace-0.8.1...

2. Export your Rackspace credentials as environment variables and edit knife.rb to read them:

   $ cat <<'EOF' >> $HOME/.bash_profile
   export RACKSPACE_USERNAME=<your_rackspace_username>
   export RACKSPACE_API_KEY=<your_rackspace_api_key>
   EOF
   $ source $HOME/.bash_profile
   $ cat <<'EOF' >> $HOME/.chef/knife.rb
   knife[:rackspace_api_username] = "#{ENV['RACKSPACE_USERNAME']}"
   knife[:rackspace_api_key] = "#{ENV['RACKSPACE_API_KEY']}"
   EOF
   $ knife rackspace server list
   Instance ID  Name  Public IP  Private IP  Flavor  Image  State

3. Prepare a new server

   1. Create a server named deis-prepare-image using the Ubuntu 12.04 LTS image, performance1-2, 1GB performance server

   2. SSH in as root with the password shown

   3. Install the 3.8 kernel with: apt-get update && apt-get install -yq linux-image-generic-lts-raring linux-headers-generic-lts-raring && reboot

   4. After reboot is complete, SSH back in as root and uname -r to confirm kernel is 3.8.0-35-generic

   5. Run the prepare-rackspace-image.sh script to optimize the image for fast boot times

      $ \curl -sSL https://raw2.github.com/opdemand/deis/master/contrib/rackspace/prepare-rackspace-image.sh | bash
      Reading package lists... Done
      Building dependency tree
      Reading state information... Done
      ...

4. Create a new image from the deis-prepare-image server named deis-base-image.

   1. In the server list in the Control Panel click the action cog for deis-prepare-image
   2. Select "Create New Image" name that image deis-base-image
   3. (optionally) Distribute the image to other regions
   4. (optionally) Create/update your Deis flavors to use your new images

5. Make sure to add the 'deis-controller' and the '<your_username>-validator' usernames to the Chef 'admins' group.

   • If you are using hosted Chef, you may need to use the older console to do this: https://manage.opscode.com/groups/admins/edit

6. Back on your machine with deis cloned and the deis CLI installed, run the provisioning script to create a new Deis controller:

   • Change <region> to match the region your image is in (we will add SYD and HKG as soon as performance flavors are available there):

     • dfw
     • ord
     • iad
     • lon

     $ cd deis
     $ ./bundle install # if you have not already done so
     $ ./contrib/rackspace/provision-rackspace-controller.sh <region>
     Provisioning a deis controller on Rackspace...
     Creating new SSH key: deis-controller
     + ssh-keygen -f /home/myuser/.ssh/deis-controller -t rsa -N '' -C deis-controller
     + set +x
     Saved to /home/myuser/.ssh/deis-controller
     Created data_bag[deis-formations]
     Created data_bag[deis-apps]
     Provisioning deis-controller with knife rackspace...
     + knife rackspace server create -y --server-create-timeout 1200 --server-name deis-controller --image 4b7c635d-89e1-44be-a15f-2877b5a660d1 --rackspace-region <region> --flavor 4 --identity-file /home/myuser/.ssh/deis-controller --bootstrap-version 11.4.4 --node-name deis-controller --run-list 'recipe[deis::controller]'
     Instance ID: de17ca36-f186-4cdd-8969-4be58e7108ea
     Name: deis-controller
     Flavor: 2GB Standard Instance
     ...