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

38 lines
2.5 KiB
Plaintext

:_content-type: ASSEMBLY
[id="installing-kn"]
= Installing the Knative CLI
include::_attributes/common-attributes.adoc[]
:context: installing-kn
toc::[]
The Knative (`kn`) CLI does not have its own login mechanism. To log in to the cluster, you must install the OpenShift (`oc`) CLI and use the `oc login` command. Installation options for the CLIs may vary depending on your operating system.
ifdef::openshift-enterprise[]
For more information on installing the OpenShift (`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 Knative (`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.
====
// need to update this note, out of scope for this PR
include::modules/serverless-installing-cli-web-console.adoc[leveloffset=+1]
include::modules/serverless-installing-cli-linux-rpm-package-manager.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]