|
| 1 | +# Knative on an OpenShift cluster |
| 2 | +------ |
| 3 | + |
| 4 | +> **IMPORTANT:** The functionality introduced by Knative on an OpenShift cluster is preview only. Red Hat support is not provided, and this release should not be used in a production environment. |
| 5 | +
|
| 6 | +## Prerequisites |
| 7 | + |
| 8 | +> **IMPORTANT:** You will need cluster administrator privileges to install and use Knative on an OpenShift cluster. |
| 9 | +
|
| 10 | +### Supported platform versions |
| 11 | + |
| 12 | +> **NOTE:** This Knative on OpenShift preview is only available via the OpenShift 4.0 developer preview. You will require a Red Hat Developers login to try this. Visit [try.openshift.com](https://try.openshift.com/) for getting started information. |
| 13 | +
|
| 14 | +| Platform | Supported versions | |
| 15 | +| ------------- |:-------------:| |
| 16 | +| OpenShift | [4.0 Developer Preview](https://try.openshift.com/) | |
| 17 | + |
| 18 | +## Installing Knative on an OpenShift cluster using the script provided |
| 19 | + |
| 20 | +1. Login to the cluster using your admin credentials. |
| 21 | + |
| 22 | + `oc login <admin-credentials>` |
| 23 | + |
| 24 | +2. Clone the `knative-operators` repository. |
| 25 | + |
| 26 | + `git clone https://github.com/openshift-cloud-functions/knative-operators` |
| 27 | + `cd knative-operators/` |
| 28 | + `git fetch --tags` |
| 29 | + `git checkout openshift-v0.3.0` |
| 30 | + |
| 31 | + |
| 32 | +3. Navigate to the newly cloned repository and run the `install.sh` script. |
| 33 | + |
| 34 | + `./etc/scripts/install.sh` |
| 35 | + |
| 36 | +>**NOTE** The installation script takes around 20-30 minutes to complete, depending on your system. |
| 37 | +
|
| 38 | +4. Once the script starts, you will see the following warning and prompt. |
| 39 | + |
| 40 | + `WARNING: This script will attempt to install Istio, Knative, and OLM in your Kubernetes/OpenShift cluster.` |
| 41 | + |
| 42 | + `If targeting OpenShift, a recent version of 'oc' should be available in your PATH. Otherwise, 'kubectl' will be used.` |
| 43 | + |
| 44 | + `If using OpenShift 3.11 and your cluster isn't minishift, ensure \$KUBE_SSH_KEY and \$KUBE_SSH_USER are set` |
| 45 | + |
| 46 | + `Pass -q to disable this prompt` |
| 47 | + |
| 48 | + `Enter to continue or Ctrl-C to exit:` |
| 49 | + |
| 50 | +5. Press Enter to continue. |
0 commit comments