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 Private](./Knative-with-ICP.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)
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.
- [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**
@ -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](./check-install-version.md)