Skip to content

Commit fb43376

Browse files
authored
Merge pull request #50597 from abrennan89/CLIbugfix
[GH#50385]: Bug fix for CLI doc prereqs
2 parents 4465439 + 301c63c commit fb43376

File tree

2 files changed

+33
-3
lines changed

2 files changed

+33
-3
lines changed

modules/serverless-installing-cli-web-console.adoc

Lines changed: 32 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Using the {product-title} web console provides a streamlined and intuitive user
1111
.Prerequisites
1212

1313
* You have logged in to the {product-title} web console.
14-
* The {ServerlessOperatorName} is installed on your {product-title} cluster.
14+
* The {ServerlessOperatorName} and Knative Serving are installed on your {product-title} cluster.
1515
+
1616
[IMPORTANT]
1717
====
@@ -23,6 +23,8 @@ $ kn: No such file or directory
2323
----
2424
====
2525
26+
* If you want to use the verification steps for this procedure, you must install the OpenShift (`oc`) CLI.
27+
2628
.Procedure
2729
2830
. Download the Knative (`kn`) CLI from the *Command Line Tools* page. You can access the *Command Line Tools* page by clicking the image:../images/question-circle.png[title="Help"] icon in the top right corner of the web console and selecting *Command Line Tools* in the list.
@@ -42,3 +44,32 @@ $ tar -xf <file>
4244
----
4345
$ echo $PATH
4446
----
47+
48+
.Verification
49+
50+
* Run the following commands to check that the correct Knative CLI resources and route have been created:
51+
+
52+
[source,terminal]
53+
----
54+
$ oc get ConsoleCLIDownload
55+
----
56+
+
57+
.Example output
58+
[source,terminal]
59+
----
60+
NAME DISPLAY NAME AGE
61+
kn kn - OpenShift Serverless Command Line Interface (CLI) 2022-09-20T08:41:18Z
62+
oc-cli-downloads oc - OpenShift Command Line Interface (CLI) 2022-09-20T08:00:20Z
63+
----
64+
+
65+
[source,terminal]
66+
----
67+
$ oc get route -n openshift-serverless
68+
----
69+
+
70+
.Example output
71+
[source,terminal]
72+
----
73+
NAME HOST/PORT PATH SERVICES PORT TERMINATION WILDCARD
74+
kn kn-openshift-serverless.apps.example.com knative-openshift-metrics-3 http-cli edge/Redirect None
75+
----

serverless/cli_tools/installing-kn.adoc

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,11 +20,10 @@ endif::[]
2020
====
2121
If you try to use an older version of the Knative (`kn`) CLI with a newer {ServerlessProductName} release, the API is not found and an error occurs.
2222
23-
For example, if you use the 1.16.0 release of the Knative (`kn`) CLI, which uses version 0.22.0, with the 1.17.0 {ServerlessProductName} release, which uses the 0.23.0 versions of the Knative Serving and Knative Eventing APIs, the CLI does not work because it continues to look for the outdated 0.22.0 API versions.
23+
For example, if you use the 1.23.0 release of the Knative (`kn`) CLI, which uses version 1.2, with the 1.24.0 {ServerlessProductName} release, which uses the 1.3 versions of the Knative Serving and Knative Eventing APIs, the CLI does not work because it continues to look for the outdated 1.2 API versions.
2424
2525
Ensure that you are using the latest Knative (`kn`) CLI version for your {ServerlessProductName} release to avoid issues.
2626
====
27-
// need to update this note, out of scope for this PR
2827

2928
include::modules/serverless-installing-cli-web-console.adoc[leveloffset=+1]
3029
include::modules/serverless-installing-cli-linux-rpm-package-manager.adoc[leveloffset=+1]

0 commit comments

Comments
 (0)