Created provider-specific installation docs, refs #227.

Author: mboersma

README.md

@@ -33,144 +33,22 @@ Free, transparent and easily customized. Join the open-source PaaS and DevOps co
 
 ## Getting Started
 
-Before you get started, read about Deis core [concepts](http://docs.deis.io/en/latest/gettingstarted/concepts/) so you can answer:
+First read about Deis core [concepts](http://docs.deis.io/en/latest/gettingstarted/concepts/) so you can answer:
 
  * What is a [Formation](http://docs.deis.io/en/latest/gettingstarted/concepts/#formations) and how does it relate to an application?
  * What are [Layers and Nodes](http://docs.deis.io/en/latest/gettingstarted/concepts/#layers), and how do they work with Chef?
  * How does the [Build, Release, Run](http://docs.deis.io/en/latest/gettingstarted/concepts/#build-release-run) process work?
  * How do I connect an application to [backing services](http://docs.deis.io/en/latest/gettingstarted/concepts/#backing-services)?
 
-Follow the steps below to install your own Deis platform on EC2. To complete the installation process, you will need [Git](http://git-scm.com), [RubyGems](http://rubygems.org/pages/download), [Pip](http://www.pip-installer.org/en/latest/installing.html), the [Amazon EC2 API Tools](http://aws.amazon.com/developertools/351), [EC2 Credentials](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/SettingUp_CommandLine.html#set_aws_credentials_linux) and a Chef Server with a working [Knife](http://docs.opscode.com/knife.html) client.
+Next, choose which cloud provider should host your Deis controller.
+Regardless of whether your controller is hosted with
+[Amazon EC2](http://docs.deis.io/en/latest/installation/ec2/),
+[Rackspace](http://docs.deis.io/en/latest/installation/rackspace/), or
+[DigitalOcean](http://docs.deis.io/en/latest/installation/digitalocean/),
+it can create and manage nodes on any of those cloud providers.
 
-*Please note: Deis is still under active development. It should not yet be used in production.*
-
-### 1. Clone the Deis Repository
-
-```bash
-$ git clone https://github.com/opdemand/deis.git
-$ cd deis
-```
-
-Cloning the default master branch will provide you with the latest development version of Deis.  If you want to deploy the latest stable release, make sure you checkout the most recent tag using ``git checkout vX.Y.Z``.
-
-### 2. Configure the Chef Server
-
-Deis requires a Chef Server. [Sign up for a free Hosted Chef account](https://getchef.opscode.com/signup) if you don’t have one.  You’ll also need a Ruby runtime with RubyGems in order to install the required Ruby dependencies.
-
-```bash
-$ bundle install    # install ruby dependencies
-$ berks install     # install cookbooks into your local berkshelf
-$ berks upload      # upload cookbooks to the chef server
-```
-
-### 3. Provision a Deis Controller
-
-The [Amazon EC2 API Tools](http://aws.amazon.com/developertools/351) will be used to setup basic EC2 infrastructure.  The [Knife EC2 plugin](https://github.com/opscode/knife-ec2) will be used to bootstrap the controller.
-
-	$ contrib/ec2/provision-ec2-controller.sh
-
-Once the `deis-controller` node exists on the Chef server, you *must* log in to the WebUI add deis-controller to the `admins` group.  This is required so the controller can delete node and client records during future scaling operations.
-
-### 4. Install the Deis Client
-
-Install the Deis client using [Pip](http://www.pip-installer.org/en/latest/installing.html) (for latest stable) or by linking `<repo>/client/deis.py` to `/usr/local/bin/deis` (for dev version).  Registration will discover SSH keys automatically and use the [standard environment variables](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/SettingUp_CommandLine.html#set_aws_credentials_linux) to configure the EC2 provider.
-
-```bash
-$ sudo pip install deis
-$ deis register http://my-deis-controller.fqdn
-username: myuser
-password:
-password (confirm):
-email: myuser@example.com
-Registered myuser
-Logged in as myuser
-
-Found the following SSH public keys:
-1) id_rsa.pub
-Which would you like to use with Deis? 1
-Uploading /Users/myuser/.ssh/id_rsa.pub to Deis... done
-
-Found EC2 credentials: AKIAJTVXXXXXXXXXXXXX
-Import these credentials? (y/n) : y
-Uploading EC2 credentials... done
-```
-
-### 5. Create & Scale a Formation
-
-Use the Deis client to create a new formation named "dev" that
-has a default layer that serves as both runtime (hosts containers)
-and proxy (routes traffic to containers).  Scale the default layer
-up to one node.
-
-```bash
-$ deis formations:create dev --flavor=ec2-us-west-2 --domain=deisapp.com
-Creating formation... done, created dev
-Creating runtime layer... done in 1s
-
-Use `deis nodes:scale dev runtime=1` to scale a basic formation
-
-$ deis nodes:scale dev runtime=1
-Scaling nodes... but first, coffee!
-...done in 251s
-
-Use `deis create --formation=dev` to create an application
-```
-
-### 6. Deploy & Scale an Application
-
-Change into your application directory and use  ``deis create --formation=dev``
-to create a new application attached to the dev formation.
-
-To deploy the application, use `git push deis master`.  Deis will automatically deploy Docker containers and configure Nginx proxies to route requests to your application.
-
-Once your application is deployed, use ``deis scale web=4`` to
-scale up web containers.  You can also use ``deis logs`` to view
-aggregated application logs, or ``deis run`` to run admin
-commands inside your application.
-
-To learn more, use `deis help` or browse [the documentation](http://docs.deis.io).
-
-```bash
-$ deis create --formation=dev
-Creating application... done, created peachy-waxworks
-Git remote deis added
-
-$ git push deis master
-Counting objects: 146, done.
-Delta compression using up to 8 threads.
-Compressing objects: 100% (122/122), done.
-Writing objects: 100% (146/146), 21.54 KiB, done.
-Total 146 (delta 84), reused 47 (delta 22)
-       Node.js app detected
------> Resolving engine versions
-       Using Node.js version: 0.10.15
-       Using npm version: 1.2.30
-...
------> Building runtime environment
------> Discovering process types
-       Procfile declares types -> web
-
------> Compiled slug size: 4.7 MB
-       Launching... done, v2
-
------> peachy-waxworks deployed to Deis
-       http://peachy-waxworks.deisapp.com ...
-
-$ curl -s http://peachy-waxworks.deisapp.com
-Powered by Deis!
-
-$ deis scale web=4
-Scaling containers... but first, coffee!
-done in 12s
-
-=== peachy-waxworks Containers
-
---- web: `node server.js`
-web.1 up 2013-09-23T19:02:30.745Z (dev-runtime-1)
-web.2 up 2013-09-23T19:36:48.741Z (dev-runtime-1)
-web.3 up 2013-09-23T19:36:48.758Z (dev-runtime-1)
-web.4 up 2013-09-23T19:36:48.771Z (dev-runtime-1)
-```
+Proceed to the [Installation](http://docs.deis.io/en/latest/installation/)
+documentation to start building your own private PaaS.
 
 ## Credits
 

client/README.rst

@@ -147,7 +147,7 @@ to route requests to your application.
 
            To learn more, use `deis help` or visit http://deis.io
 
-    To git@deis.mattboersma.com:nimbus-pamphlet.git
+    To git@198.51.100.22:nimbus-pamphlet.git
      * [new branch]      master -> master
 
     $ curl -s http://ec2-198.51.100.22.us-west-2.compute.amazonaws.com

docs/contributing/index.rst

@@ -16,4 +16,5 @@ Contributing
     standards
     community
     conduct
+    releases
 

docs/releases.rst docs/contributing/releases.rstdocs/releases.rst renamed to docs/contributing/releases.rst

@@ -11,6 +11,5 @@ Getting Started
     :maxdepth: 1
 
     concepts
-    installation
-    usage    
-    tutorial
+    terms/index
+    usage