Merge pull request #35 from slack/platform-to-workflow

Start massaging Workflow into docs

Author: Jason Hansen

mkdocs.yml

@@ -12,7 +12,7 @@ pages:
   - Installing Deis:
     - Quick Start: installing-deis/quickstart.md
     - System Requirements: installing-deis/system-requirements.md
-    - Installing the Deis Platform: installing-deis/installing-the-deis-platform.md
+    - Installing Deis Workflow: installing-deis/installing-deis-workflow.md
   - Using Deis:
     - Installing the Client: using-deis/installing-the-client.md
     - Registering a User: using-deis/registering-a-user.md

src/index.md

@@ -1,8 +1,10 @@
-# Welcome
+# Welcome to Deis Workflow
 
-Deis (pronounced DAY-iss) is an open source PaaS that makes it easy to deploy and manage applications on your own servers. Deis builds upon Kubernetes to provide a lightweight PaaS with a Heroku-inspired workflow.
+Deis (pronounced DAY-iss) Workflow is an open source PaaS that makes it easy to deploy and manage applications on your own servers. Deis Workflow adds a developer-friendly Platform as a Service (PaaS) layer to any Kubernetes cluster, including: a simple REST API, application log aggregation, release and rollback, edge routing, git-push-to-container image, and authentication and authorization.
 
-To get started with Deis, first read the [Architecture][arch] and [Concepts][concepts] of Deis, then use [the QuickStart documentation][quickstart] to start provisioning your cluster.
+To get started with Workflow, follow our [Quick Start][quickstart] guide.
+
+For more detailed information about Workflow view the [Architecture][arch] and [Concepts][concepts] sections.
 
 [arch]: understanding-deis/architecture.md
 [concepts]: understanding-deis/concepts.md

src/installing-deis/installing-deis-workflow.md

@@ -0,0 +1,71 @@
+# Installing Deis Workflow
+
+We will use the `helm` utility to install Deis Workflow onto a Kubernetes cluster. If you don't
+have `helm` installed, see [installing helm][helm] for more info.
+
+## Check Your Setup
+
+First check that you have `helm` installed and the version is correct.
+
+```
+$ helm --version
+0.4.0
+```
+
+Ensure your kubectl client is installed and ensure it can connect to your Kubernetes cluster. This
+is where `helm` will attempt to communicate with the cluster. You can test that it is working
+properly by running:
+
+```
+$ helm target
+Kubernetes master is running at https://10.245.1.2
+Heapster is running at https://10.245.1.2/api/v1/proxy/namespaces/kube-system/services/heapster
+KubeDNS is running at https://10.245.1.2/api/v1/proxy/namespaces/kube-system/services/kube-dns
+KubeUI is running at https://10.245.1.2/api/v1/proxy/namespaces/kube-system/services/kube-ui
+Grafana is running at https://10.245.1.2/api/v1/proxy/namespaces/kube-system/services/monitoring-grafana
+InfluxDB is running at https://10.245.1.2/api/v1/proxy/namespaces/kube-system/services/monitoring-influxdb
+```
+
+If you see a list of targets like the one above, 'helm' can communicate with the kubernetes master.
+
+## Get the Helm Chart
+
+The [Deis Chart Repository](https://github.com/deis/charts) contains everything you
+need to install Deis onto your Kubernetes cluster, with a single `helm install` command.
+
+Run the following commands to set up your Helm environment and install the chart:
+
+```
+$ helm update
+$ helm repo add deis https://github.com/deis/charts
+$ helm fetch deis/deis
+```
+
+## Install Deis Workflow
+
+Now that you have Helm installed and added the Deis Chart Repository, install Workflow by running:
+
+```
+$ helm install deis/deis --namespace=deis
+```
+
+Helm will install a variety of Kubernetes resources in the `deis` namespace.
+You'll need to wait for the pods that it launched to be ready. Monitor their status
+by running:
+
+```
+$ kubectl get pods --namespace=deis
+```
+
+If you would like `kubectl` to automatically update as the pod states change, run (type Ctrl-C to stop the watch):
+```
+$ kubectl get pods --namespace=deis -w
+```
+
+Once you see all of the pods in the `READY` state, Deis Workflow is up and running!
+
+Next, [configure dns][] so you can register your first user.
+
+[helm]: http://helm.sh
+[using deis]: ../using-deis/deploying-an-application.md
+[configure dns]: ../managing-deis/configuring-dns.md

src/installing-deis/installing-the-deis-platform.md

@@ -1,6 +1,6 @@
 # Quick Start
 
-These steps will help you provision a Deis cluster.
+These steps will help you install and configure Deis Workflow on a Kubernetes cluster.
 
 ## Check System Requirements
 
@@ -16,23 +16,23 @@ Choose one of the following providers and deploy a new Kubernetes cluster:
 
 Reference [this table](http://kubernetes.io/v1.1/docs/getting-started-guides/#table-of-solutions) in the official Kubernetes documentation for a more extensive (but still non-exhaustive) list of Kubernetes provisioning options supported by the project or the community.
 
-## Install Deis Platform
+## Install Deis Workflow
 
-Now that you've finished provisioning a cluster, please [Install the Deis Platform][install deis].
+Now that you've finished provisioning a cluster, please [Install Deis Workflow][install deis].
 
 ## Configure DNS
 
 See [Configuring DNS][] for more information on properly setting up your DNS records with Deis.
 
 ## Register a User
 
-Once your cluster has been provisioned and the Deis Platform has been installed, you can
+Once your cluster has been provisioned and Deis Workflow has been installed, you can
 [install the client][client] and [register your first user][register]!
 
 
 [client]: ../using-deis/installing-the-client.md
 [configuring object storage]: configuring-object-storage.md
 [configuring dns]: ../managing-deis/configuring-dns.md
-[install deis]: installing-the-deis-platform.md
+[install deis]: installing-deis-workflow.md
 [register]: ../using-deis/registering-a-user.md
 [system requirements]: system-requirements.md

src/installing-deis/quickstart.md

@@ -55,7 +55,7 @@ The Controller stack includes:
 
 - Django API Server for handling API calls
 
-Follow the [Installing Deis](../installing-deis/installing-the-deis-platform.md) guide to create your own private Deis controller.
+Follow the [Installing Deis](../installing-deis/installing-deis-workflow.md) guide to create your own private Deis controller.
 
 
 ## Key