1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Files
openshift-docs/serverless/cli_tools/installing-kn.adoc
2022-02-25 16:48:31 -05:00

40 lines
2.4 KiB
Plaintext

:_content-type: ASSEMBLY
[id="installing-kn"]
= Installing the Knative CLI
include::_attributes/common-attributes.adoc[]
include::_attributes/serverless-document-attributes.adoc[]
:context: installing-kn
toc::[]
Installation options for the `oc` CLI may vary depending on your operating system.
The Knative CLI (`kn`) does not have its own login mechanism. To log in to the cluster, you must install the `oc` CLI and use the `oc login` command.
ifdef::openshift-enterprise[]
For more information on installing the `oc` CLI for your operating system and logging in with `oc`, see the xref:../../cli_reference/openshift_cli/getting-started-cli.adoc#cli-getting-started[OpenShift CLI getting started] documentation.
endif::[]
// need to wait til CLI docs are added to OSD for this link to work
// TODO: remove this conditional once this is available
{ServerlessProductName} cannot be installed using the `kn` CLI. A cluster administrator must install the {ServerlessOperatorName} and set up the Knative components, as described in the xref:../../serverless/install/install-serverless-operator.adoc#install-serverless-operator[Installing the {ServerlessOperatorName}] documentation.
[IMPORTANT]
====
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.
For example, if you use the 1.16.0 release of the `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.
Ensure that you are using the latest `kn` CLI version for your {ServerlessProductName} release to avoid issues.
====
include::modules/serverless-installing-cli-web-console.adoc[leveloffset=+1]
include::modules/serverless-installing-cli-linux-rpm.adoc[leveloffset=+1]
include::modules/serverless-installing-cli-linux.adoc[leveloffset=+1]
include::modules/serverless-installing-cli-linux-ibm-power-rpm.adoc[leveloffset=+1]
include::modules/serverless-installing-cli-linux-ibm-power-tarball.adoc[leveloffset=+1]
include::modules/serverless-installing-cli-linux-ibm-z-rpm.adoc[leveloffset=+1]
include::modules/serverless-installing-cli-linux-ibm-z-tarball.adoc[leveloffset=+1]
include::modules/serverless-installing-cli-macos.adoc[leveloffset=+1]
include::modules/serverless-installing-cli-windows.adoc[leveloffset=+1]