Organizing install guides; adding link to Custom Install guide. (#565)

* Organizing install guides; adding link to Custom Install guide.

* Adding links to samples for all components.

* Updating install versions

* Resolving conflicts, updating README

* update to Serving 0.2.3

* update to Serving 0.2.3

* update to Serving 0.2.3

* update to Serving 0.2.3

* update to Serving 0.2.3

* update to Serving 0.2.3

Author: samodell

install/Knative-with-AKS.md

@@ -132,8 +132,8 @@ Knative depends on Istio.
 
 1. Install Istio:
    ```bash
-   kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/istio-crds.yaml && \
-   kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/istio.yaml
+   kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.3/istio-crds.yaml && \
+   kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.3/istio.yaml
    ```
    Note: the resources (CRDs) defined in the `istio-crds.yaml`file are
    also included in the `istio.yaml` file, but they are pulled out so that
@@ -157,60 +157,41 @@ rerun the command to see the current status.
 > command to view the component's status updates in real time. Use CTRL + C to
 > exit watch mode.
 
-## Installing Knative components
+## Installing Knative
 
-You can install the Knative Serving and Build components together, or Build on
-its own.
-
-### Installing Knative Serving and Build components
+The following commands install all available Knative components. To customize
+your Knative installation, see [Performing a Custom Knative Installation](Knative-custom-install.md).
 
 1. Run the `kubectl apply` command to install Knative and its dependencies:
-   ```bash
-   kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/release.yaml
-   ```
-1. Monitor the Knative components until all of the components show a `STATUS` of
-   `Running`:
-   ```bash
-   kubectl get pods --namespace knative-serving
-   kubectl get pods --namespace knative-build
-   ```
-
-### Installing Knative Build only
-
-1. Run the `kubectl apply` command to install
-   [Knative Build](https://github.com/knative/build) and its dependencies:
-   ```bash
-   kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/build.yaml
-   ```
-1. Monitor the Knative Build components until all of the components show a
+    ```bash
+    kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.3/release.yaml /
+    --filename https://github.com/knative/eventing/releases/download/v0.2.1/eventing.yaml /
+    --filename --filename https://github.com/knative/eventing-sources/releases/download/v0.2.1/release.yaml
+    ```
+1. Monitor the Knative components until all of the components show a
    `STATUS` of `Running`:
-   ```bash
-   kubectl get pods --namespace knative-build
-   ```
-
-Just as with the Istio components, it will take a few seconds for the Knative
-components to be up and running; you can rerun the `kubectl get` command to see
-the current status.
-
-> Note: Instead of rerunning the command, you can add `--watch` to the above
-> command to view the component's status updates in real time. Use CTRL + C to
-> exit watch mode.
-
-You are now ready to deploy an app or create a build in your new Knative
-cluster.
+    ```bash
+    kubectl get pods --namespace knative-serving
+    kubectl get pods --namespace knative-build
+    kubectl get pods --namespace knative-eventing
+    kubectl get pods --namespace knative-sources
+    kubectl get pods --namespace knative-monitoring
+    ```
 
-## Deploying an app
+## What's next
 
-Now that your cluster has Knative installed, you're ready to deploy an app.
+Now that your cluster has Knative installed, you can see what Knative has to
+offer.
 
-You have two options for deploying your first app:
+To deploy your first app with Knative, follow the step-by-step
+[Getting Started with Knative App Deployment](getting-started-knative-app.md)
+guide.
 
-- You can follow the step-by-step
-  [Getting Started with Knative App Deployment](getting-started-knative-app.md)
-  guide.
+To get started with Knative Eventing, pick one of the
+[Eventing Samples](../eventing/samples/) to walk through.
 
-- You can view the available [sample apps](../serving/samples/README.md) and
-  deploy one of your choosing.
+To get started with Knative Build, read the
+[Build README](../build/README.md), then choose a sample to walk through.
 
 ## Cleaning up
 

install/Knative-with-GKE.md

@@ -1,7 +1,7 @@
 # Knative Install on Google Kubernetes Engine
 
-This guide walks you through the installation of the latest version of Knative
-using pre-built images.
+This guide walks you through the installation of the latest version of all
+Knative components using pre-built images.
 
 You can find [guides for other platforms here](README.md).
 
@@ -132,8 +132,8 @@ Knative depends on Istio.
 
 1. Install Istio:
    ```bash
-   kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/istio-crds.yaml && \
-   kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/istio.yaml
+   kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.3/istio-crds.yaml && \
+   kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.3/istio.yaml
    ```
    Note: the resources (CRDs) defined in the `istio-crds.yaml`file are
    also included in the `istio.yaml` file, but they are pulled out so that
@@ -158,65 +158,41 @@ rerun the command to see the current status.
 > command to view the component's status updates in real time. Use CTRL + C to
 > exit watch mode.
 
-## Installing Knative components
+## Installing Knative
 
-You can install the Knative Serving and Build components together, or Build on
-its own.
-
-### Installing Knative Serving and Build components
+The following commands install all available Knative components. To customize
+your Knative installation, see [Performing a Custom Knative Installation](Knative-custom-install.md).
 
 1. Run the `kubectl apply` command to install Knative and its dependencies:
-   ```bash
-   kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/release.yaml
-   ```
-1. Monitor the Knative components until all of the components show a `STATUS` of
-   `Running`:
-   ```bash
-   kubectl get pods --namespace knative-serving
-   kubectl get pods --namespace knative-build
-   ```
-
-### Installing Knative Build only
-
-1. Run the `kubectl apply` command to install
-   [Knative Build](https://github.com/knative/build) and its dependencies:
-   ```bash
-   kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/build.yaml
-   ```
-1. Monitor the Knative Build components until all of the components show a
+    ```bash
+    kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.3/release.yaml /
+    --filename https://github.com/knative/eventing/releases/download/v0.2.1/eventing.yaml /
+    --filename --filename https://github.com/knative/eventing-sources/releases/download/v0.2.1/release.yaml
+    ```
+1. Monitor the Knative components until all of the components show a
    `STATUS` of `Running`:
-   ```bash
-   kubectl get pods --namespace knative-build
-   ```
-
-Just as with the Istio components, it will take a few seconds for the Knative
-components to be up and running; you can rerun the `kubectl get` command to see
-the current status.
-
-> Note: Instead of rerunning the command, you can add `--watch` to the above
-> command to view the component's status updates in real time. Use CTRL + C to
-> exit watch mode.
-
-You are now ready to deploy an app or create a build in your new Knative
-cluster.
+    ```bash
+    kubectl get pods --namespace knative-serving
+    kubectl get pods --namespace knative-build
+    kubectl get pods --namespace knative-eventing
+    kubectl get pods --namespace knative-sources
+    kubectl get pods --namespace knative-monitoring
+    ```
 
 ## What's next
 
-Now that your cluster has Knative installed, you're ready to deploy an app or
-create a build.
-
-Depending on which Knative component you have installed, there are a few options
-for getting started:
+Now that your cluster has Knative installed, you can see what Knative has to
+offer.
 
-- You can follow the step-by-step
-  [Getting Started with Knative App Deployment](getting-started-knative-app.md)
-  guide.
+To deploy your first app with Knative, follow the step-by-step
+[Getting Started with Knative App Deployment](getting-started-knative-app.md)
+guide.
 
-- You can view the available [sample apps](../serving/samples/README.md) and
-  deploy one of your choosing.
+To get started with Knative Eventing, pick one of the
+[Eventing Samples](../eventing/samples/) to walk through.
 
-- You can follow the step-by-step
-  [Creating a simple Knative Build](../build/creating-builds.md) guide.
+To get started with Knative Build, read the
+[Build README](../build/README.md), then choose a sample to walk through.
 
 ## Cleaning up
 

install/Knative-with-Gardener.md

@@ -71,8 +71,8 @@ Knative depends on Istio.
 
 1.  Install Istio:
     ```bash
-	kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/istio-crds.yaml && \
-    kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/istio.yaml
+	kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.3/istio-crds.yaml && \
+    kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.3/istio.yaml
     ```
     Note: the resources (CRDs) defined in the `istio-crds.yaml`file are
     also included in the `istio.yaml` file, but they are pulled out so that
@@ -94,47 +94,26 @@ rerun the command to see the current status.
 > command to view the component's status updates in real time. Use CTRL + C to
 > exit watch mode.
 
-## Installing Knative components
+## Installing Knative
 
-You can install the Knative Serving and Build components together, or Build on
-its own.
-
-### Installing Knative Serving and Build components
+The following commands install all available Knative components. To customize
+your Knative installation, see [Performing a Custom Knative Installation](Knative-custom-install.md).
 
 1. Run the `kubectl apply` command to install Knative and its dependencies:
-   ```bash
-   kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/release.yaml
-   ```
-1. Monitor the Knative components until all of the components show a `STATUS` of
-   `Running`:
-   ```bash
-   kubectl get pods --namespace knative-serving
-   kubectl get pods --namespace knative-build
-   ```
-
-### Installing Knative Build only
-
-1. Run the `kubectl apply` command to install
-   [Knative Build](https://github.com/knative/build) and its dependencies:
-   ```bash
-   kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.2/build.yaml
-   ```
-1. Monitor the Knative Build components until all of the components show a
+    ```bash
+    kubectl apply --filename https://github.com/knative/serving/releases/download/v0.2.3/release.yaml /
+    --filename https://github.com/knative/eventing/releases/download/v0.2.1/eventing.yaml /
+    --filename --filename https://github.com/knative/eventing-sources/releases/download/v0.2.1/release.yaml
+    ```
+1. Monitor the Knative components until all of the components show a
    `STATUS` of `Running`:
-   ```bash
-   kubectl get pods --namespace knative-build
-   ```
-
-Just as with the Istio components, it will take a few seconds for the Knative
-components to be up and running; you can rerun the `kubectl get` command to see
-the current status.
-
-> Note: Instead of rerunning the command, you can add `--watch` to the above
-> command to view the component's status updates in real time. Use CTRL + C to
-> exit watch mode.
-
-You are now ready to deploy an app or create a build in your new Knative
-cluster.
+    ```bash
+    kubectl get pods --namespace knative-serving
+    kubectl get pods --namespace knative-build
+    kubectl get pods --namespace knative-eventing
+    kubectl get pods --namespace knative-sources
+    kubectl get pods --namespace knative-monitoring
+    ```
 
 ## Alternative way to enable Knative with Gardener
 
@@ -168,10 +147,10 @@ spec:
 And of course create the respective `ConfigMaps`:
 
 ```
-curl https://github.com/knative/serving/releases/download/v0.2.2/istio.yaml
+curl https://github.com/knative/serving/releases/download/v0.2.3/istio.yaml
 kubectl create configmap istio-chart-080 --from-file=istio.yaml
 
-curl https://github.com/knative/serving/releases/download/v0.2.2/release.yaml
+curl https://github.com/knative/serving/releases/download/v0.2.3/release.yaml
 kubectl create configmap knative-chart-001 --from-file=release.yaml
 ```
 
@@ -210,17 +189,20 @@ kind: ConfigMap
   namespace: knative-serving
 ```
 
-## Deploying an app
+## What's next
 
-Now that your cluster has Knative installed, you're ready to deploy an app.
+Now that your cluster has Knative installed, you can see what Knative has to
+offer.
 
-If you'd like to follow a step-by-step guide for deploying your first app on
-Knative, check out the
+To deploy your first app with Knative, follow the step-by-step
 [Getting Started with Knative App Deployment](getting-started-knative-app.md)
 guide.
 
-If you'd like to view the available sample apps and deploy one of your choosing,
-head to the [sample apps](../serving/samples/README.md) repo.
+To get started with Knative Eventing, pick one of the
+[Eventing Samples](../eventing/samples/) to walk through.
+
+To get started with Knative Build, read the
+[Build README](../build/README.md), then choose a sample to walk through.
 
 ## Cleaning up