From b8ae42da242657dc94d9f24aa3d77e77a0d75c9c Mon Sep 17 00:00:00 2001
From: Brendan Nolan <bnolan@pivotal.io>
Date: Fri, 20 Jul 2018 18:44:38 +0100
Subject: [PATCH] Document Knative installation instructions for PKS (#216)

* Reference existing documentation for PKS installation

[#159168349]
---
 install/Knative-with-PKS.md | 89 +++++++++++++++++++++++++++++++++++++
 install/README.md           |  1 +
 2 files changed, 90 insertions(+)
 create mode 100644 install/Knative-with-PKS.md

diff --git a/install/Knative-with-PKS.md b/install/Knative-with-PKS.md
new file mode 100644
index 000000000..b89c8dde0
--- /dev/null
+++ b/install/Knative-with-PKS.md
@@ -0,0 +1,89 @@
+# Knative Install on Pivotal Container Service
+
+This guide walks you through the installation of the latest version of
+Knative using pre-built images.
+
+You can find [guides for other platforms here](README.md).
+
+## Before you begin
+
+Knative requires a Kubernetes cluster v1.10 or newer. `kubectl` v1.10 is also
+required.  This guide walks you through creating a cluster with the correct
+specifications for Knative on Pivotal Container Service.
+
+This guide assumes you are using bash in a Mac or Linux environment; some
+commands will need to be adjusted for use in a Windows environment.
+
+### Installing Pivotal Container Service
+
+To install Pivotal Container Service (PKS), follow the documentation at https://docs.pivotal.io/runtimes/pks/1-1/installing-pks.html.
+
+## Creating a Kubernetes cluster
+
+To create a cluster, follow the documentation at https://docs.pivotal.io/runtimes/pks/1-1/create-cluster.html
+
+## Access the cluster
+
+To retrieve your cluster credentials, follow the documentation at https://docs.pivotal.io/runtimes/pks/1-1/cluster-credentials.html.
+
+## Installing Istio
+
+Knative depends on Istio. Istio workloads require privileged mode for Init Containers
+
+1. Install Istio:
+    ```bash
+    kubectl apply -f https://storage.googleapis.com/knative-releases/latest/istio.yaml
+    ```
+1. Label the default namespace with `istio-injection=enabled`:
+    ```bash
+    kubectl label namespace default istio-injection=enabled
+    ```
+1. Monitor the Istio components until all of the components show a `STATUS` of
+`Running` or `Completed`:
+    ```bash
+    kubectl get pods -n istio-system
+    ```
+
+It will take a few minutes for all the components to be up and running; you can
+rerun the 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.
+
+## Installing Knative Serving
+
+1. Next, we will install [Knative Serving](https://github.com/knative/serving)
+and its dependencies:
+    ```bash
+    kubectl apply -f https://storage.googleapis.com/knative-releases/latest/release.yaml
+    ```
+1. Monitor the Knative components, until all of the components show a `STATUS` of
+`Running`:
+    ```bash
+    kubectl get pods -n knative-serving
+    ```
+
+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 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 to your new Knative cluster.
+
+## Deploying an app
+
+Now that your cluster has Knative installed, you're ready to deploy an app.
+
+You have two options for deploying your first app:
+
+* You can 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.
+
+## Cleaning up
+
+To delete the cluster, follow the documentation at https://docs.pivotal.io/runtimes/pks/1-1/delete-cluster.html.
\ No newline at end of file
diff --git a/install/README.md b/install/README.md
index 5b2779649..8bb64ba86 100644
--- a/install/README.md
+++ b/install/README.md
@@ -19,6 +19,7 @@ Knative components on the following platforms:
 
 * [Knative Install on Gardener](Knative-with-Gardener.md)
 * [Knative Install on Google Kubernetes Engine](Knative-with-GKE.md)
+* [Knative Install on Pivotal Container Service](Knative-with-PKS.md)
 * [Knative Install on IBM Cloud Kubernetes Service](Knative-with-IKS.md)
 * [Knative Install on Azure Kubernetes Service](Knative-with-AKS.md)
 * [Knative Install on Minikube](Knative-with-Minikube.md)