knative
/
docs
mirror of https://github.com/knative/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Removed outdated OpenShift installation docs, new link added for actual product docs (#1815)

This commit is contained in:
Ashleigh Brennan 2019-09-23 23:44:24 +01:00 committed by Knative Prow Robot
parent db58bb086e
commit 04e934a841
2 changed files with 1 additions and 132 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

128
docs/install/Knative-with-OpenShift.md
View File

@ -1,128 +0,0 @@
---
title: "Install on OpenShift"
linkTitle: "OpenShift"
weight: 15
type: "docs"
---
# Knative Install on OpenShift
This guide walks you through the installation of the latest version of
[Knative Serving](https://github.com/knative/serving) on
[OpenShift](https://github.com/openshift/origin) by using the Knative Serving
Operator. The operator is available on the OpenShift OperatorHub. After you
install Knative Serving, this guide walks you through creating and deploying an
image of a sample "Hello World" app onto the new Knative cluster.
You can find [guides for other platforms here](./README.md).
## Before you begin
- An OpenShift 4 cluster is required for installation. Visit
[try.openshift.com](https://try.openshift.com) for information on setting up a
cluster. You will need cluster administrator privileges to install and use
Knative on an OpenShift cluster.
## Installing the Knative Serving Operator
1. Go to **Catalog > OperatorHub** in the
[OpenShift Web Console](https://www.openshift.com/). A list of operators for
OpenShift, provided by Red Hat as well as a community of partners and
open-source projects is provided. Click on the **Knative Serving Operator**
tile.
> **NOTE:** Use the **Filter by Keyword** box to help you find the Knative
> Serving operator in the catalog.
![KSO Tile](./images/knative_serving_tile_highlighted.png)
2. A **Show Community Operator** dialog box will open. Click **Continue** to
proceed.
3. The **Knative Serving Operator** descriptor screen will appear. Click
**Install**.
![KSO Install Screen](./images/knative_serving_operator_screen.png)
4. On the **Create the Operator Subscription** screen, create a new subscription
by clicking on the **Subscribe** button. This will install the Knative
Serving Operator in the project `openshift-operators` and Knative Serving in
the `knative-serving` project.
![KSO Namespaces Default](./images/knative_serving_namespaces_default.png)
> **NOTE:** The Operator Lifecycle Manager (OLM) installs the operator, which
> will automatically install Knative. This installation will create the
> `knative-serving`, `istio-operator`, and `istio-system` namespaces.
5. Verify the subscription status for the installation operator, by viewing the
**Subscription Overview**. The **UPGRADE STATUS** will update from
`0 Installing` to `1 Installed`.
> **NOTE:** The screen will update after a few minutes. Wait for the
> `knative-serving` namespace to appear in the project drop-down menu. Refresh
> the page if needed.
![KSO Upgrade Status](./images/knative_serving_installed_sub.png)
6. Knative Serving is now installed. Navigate to **Catalog > Installed
Operators** to confirm the operator is installed. Click on
**knative-serving** to view the install status.
![KSO installed](./images/knative_serving_installed_operator.png)
## Deploying an app
Now that your cluster has Knative installed, you're ready to deploy an app.
If you'd like to follow a step-by-step guide for deploying your first app on
Knative, check out the
[Getting Started with Knative App Deployment](../serving/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.
> **NOTE:** When looking up the IP address to use for accessing your app, you
> need to look up the NodePort for the `istio-ingressgateway` well as the IP
> address used for OpenShift. You can use the following command to look up the
> value to use for the {IP_ADDRESS} placeholder used in the samples:
```shell
# In Knative 0.2.x and prior versions, the `knative-ingressgateway` service was used instead of `istio-ingressgateway`.
INGRESSGATEWAY=knative-ingressgateway
# The use of `knative-ingressgateway` is deprecated in Knative v0.3.x.
# Use `istio-ingressgateway` instead, since `knative-ingressgateway`
# will be removed in Knative v0.4.
if kubectl get configmap config-istio -n knative-serving &> /dev/null; then
INGRESSGATEWAY=istio-ingressgateway
fi
export IP_ADDRESS=$(oc get node -o 'jsonpath={.items[0].status.addresses[0].address}'):$(oc get svc $INGRESSGATEWAY -n istio-system -o 'jsonpath={.spec.ports[?(@.port==80)].nodePort}')
```
## Uninstalling the Knative Serving Operator
1. Go to **Catalog > OperatorHub** in the OpenShift Web Console.
2. Click on the **Knative Serving Operator** tile.
![KSO Uninstall Tile](./images/knative_serving_uninstall_tile.png)
> **NOTE:** The operator tile will indicate it is installed.
3. The **Show Community Operator**` dialog box will appear. Click **Continue**
to proceed.
4. Once the **Knative Serving Operator** descriptor screen appears, click
**Uninstall**.
![KSO Uninstall](./images/knative_serving_uninstall_operator.png)
5. Select **Also completely remove the Operator from the selected namespace**,
in the **Remove Operator Subscription** dialog box.
6. Click **Remove**.

5
docs/install/README.md
View File

@ -74,6 +74,7 @@ available Knative components and a set of observability plugins.
- [Knative Install on IBM Cloud Kubernetes Service](./Knative-with-IKS.md) - [Knative Install on IBM Cloud Kubernetes Service](./Knative-with-IKS.md)
- [Knative Install on IBM Cloud Private](./Knative-with-ICP.md) - [Knative Install on IBM Cloud Private](./Knative-with-ICP.md)
- [Knative Install on Minikube](./Knative-with-Minikube.md) - [Knative Install on Minikube](./Knative-with-Minikube.md)
- [Knative Install on OpenShift Container Platform](https://docs.openshift.com/container-platform/4.1/serverless/installing-openshift-serverless.html)
- [Knative Install on Pivotal Container Service](./Knative-with-PKS.md) - [Knative Install on Pivotal Container Service](./Knative-with-PKS.md)
If you already have a Kubernetes cluster you're comfortable installing _alpha_ If you already have a Kubernetes cluster you're comfortable installing _alpha_
@ -87,8 +88,6 @@ The guides below install some of the available Knative components, without all
available observability plugins, to minimize the disk space used for install. available observability plugins, to minimize the disk space used for install.
- [Knative Install on Docker for Mac](./Knative-with-Docker-for-Mac.md) - [Knative Install on Docker for Mac](./Knative-with-Docker-for-Mac.md)
- [Knative Install on OpenShift](./Knative-with-OpenShift.md)
- [Knative Install on OpenShift via Operator](https://github.com/openshift-knative/docs/blob/master/README.md)
**Custom install guide** **Custom install guide**
@ -137,5 +136,3 @@ and set up an Istio IP range for outbound network access:
## Checking the version of your Knative Serving installation ## Checking the version of your Knative Serving installation
- [Checking the version of your Knative Serving installation](./check-install-version.md) - [Checking the version of your Knative Serving installation](./check-install-version.md)