3.3. 安装 Knative CLI
Knative (kn
) CLI 本身没有登录机制。要登录到集群,您必须安装 OpenShift CLI (oc
),并使用 oc login
命令。CLI 的安装选项可能会因您的操作系统而异。
有关为您的操作系统安装 OpenShift CLI (oc
) 并使用 oc
登录的更多信息,请参阅 OpenShift CLI 启动 文档。
OpenShift Serverless 不能使用 Knative (kn
) CLI 安装。集群管理员必须安装 OpenShift Serverless Operator 并设置 Knative 组件,如 安装 OpenShift Serverless Operator 文档所述。
如果您试图将较旧版本的 Knative kn
CLI 与较新的 OpenShift Serverless 发行版本搭配使用,则不会找到 API,并出现错误。
例如,您使用 1.23.0 版本的 Knative (kn
) CLI(使用版本 1.2),以及 1.24.0 版本的 OpenShift Serverless(使用版本 1.3 的 Knative Serving 和 Knative Eventing API),则 CLI 将无法正常工作,因为它会一直寻找已过时的 1.2 版本的 API。
确保为 OpenShift Serverless 版本使用最新的 Knative (kn
) CLI 版本以避免出现问题。
3.3.1. 使用 OpenShift Container Platform Web 控制台安装 Knative CLI
使用 OpenShift Container Platform Web 控制台提供了一个简洁、直观的用户界面来安装 Knative (kn
) CLI。安装 OpenShift Serverless Operator 后,您会看到从 OpenShift Container Platform Web 控制台的 Command Line Tools 页面中下载适用于 Linux 的 Knative (kn
) CLI 的链接(amd64、s390x、ppc64le)、macOS 或 Windows。
先决条件
- 已登陆到 OpenShift Container Platform Web 控制台。
OpenShift Serverless Operator 和 Knative Serving 已安装在 OpenShift Container Platform 集群中。
重要如果 libc 不可用,您在运行 CLI 命令时可能会看到以下错误:
$ kn: No such file or directory
-
如果要使用验证步骤,您必须安装 OpenShift (
oc
) CLI。
流程
-
从 Command Line Tools 页面下载 Knative (
kn
) CLI。您可以点 web 控制台右上角的 图标进入 Command Line Tools 页,并在列表中选择 Command Line Tools。 解包存档:
$ tar -xf <file>
-
将
kn
二进制文件移到PATH
中的目录中。 运行以下命令可以查看
PATH
的值:$ echo $PATH
验证
运行以下命令检查是否已创建了正确的 Knative CLI 资源和路由:
$ oc get ConsoleCLIDownload
输出示例
NAME DISPLAY NAME AGE kn kn - OpenShift Serverless Command Line Interface (CLI) 2022-09-20T08:41:18Z oc-cli-downloads oc - OpenShift Command Line Interface (CLI) 2022-09-20T08:00:20Z
$ oc get route -n openshift-serverless
输出示例
NAME HOST/PORT PATH SERVICES PORT TERMINATION WILDCARD kn kn-openshift-serverless.apps.example.com knative-openshift-metrics-3 http-cli edge/Redirect None
3.3.2. 使用 RPM 软件包管理器为 Linux 安装 Knative CLI
对于 Red Hat Enterprise Linux (RHEL) ,您可以使用软件包管理器(如 yum
或 dnf
)将 Knative (kn
) CLI 作为 RPM 安装。这允许系统自动管理 Knative CLI 版本。例如,如果有新版本可用,使用 dnf upgrade
一样的命令升级所有软件包,包括 kn
。
先决条件
- 您的红帽帐户必须具有有效的 OpenShift Container Platform 订阅。
流程
使用 Red Hat Subscription Manager 注册:
# subscription-manager register
获取最新的订阅数据:
# subscription-manager refresh
将订阅附加到注册的系统:
# subscription-manager attach --pool=<pool_id> 1
- 1
- 活跃的 OpenShift Container Platform 订阅的池 ID
启用 Knative (
kn
) CLI 所需的仓库:Linux (x86_64, amd64)
# subscription-manager repos --enable="openshift-serverless-1-for-rhel-8-x86_64-rpms"
Linux on IBM Z and LinuxONE (s390x)
# subscription-manager repos --enable="openshift-serverless-1-for-rhel-8-s390x-rpms"
Linux on IBM Power (ppc64le)
# subscription-manager repos --enable="openshift-serverless-1-for-rhel-8-ppc64le-rpms"
使用软件包管理器将 Knative (
kn
) CLI 作为 RPM 安装:yum
命令示例# yum install openshift-serverless-clients
3.3.3. 为 Linux 安装 Knative CLI
如果您使用没有 RPM 或者另一个软件包管理器的 Linux 发行版本,您可以将 Knative (kn
) CLI 安装为二进制文件。要做到这一点,您必须下载并解包一个 tar.gz
存档,并将二进制文件添加到 PATH
的目录中。
先决条件
如果您不使用 RHEL 或 Fedora,请确保将 libc 安装在库路径的目录中。
重要如果 libc 不可用,您在运行 CLI 命令时可能会看到以下错误:
$ kn: No such file or directory
流程
下载相关的 Knative (
kn
) CLItar.gz
存档:您还可以通过进入到 Serverless 客户端下载镜像 中的相应目录来下载任何
kn
版本。解包存档:
$ tar -xf <filename>
-
将
kn
二进制文件移到PATH
中的目录中。 运行以下命令可以查看
PATH
的值:$ echo $PATH
3.3.4. 为 macOS 安装 Knative CLI
如果使用 macOS,您可以将 Knative (kn
) CLI 安装为二进制文件。要做到这一点,您必须下载并解包一个 tar.gz
存档,并将二进制文件添加到 PATH
的目录中。
流程
下载 Knative (
kn
) CLItar.gz
存档。您还可以通过进入到 Serverless 客户端下载镜像 中的相应目录来下载任何
kn
版本。- 解包并提取存档。
-
将
kn
二进制文件移到PATH
中的目录中。 要查看
PATH
,打开终端窗口并运行:$ echo $PATH
3.3.5. 为 Windows 安装 Knative CLI
如果使用 Windows,您可以将 Knative (kn
) CLI 安装为二进制文件。要做到这一点,您必须下载并解包 ZIP 存档,并将二进制文件添加到 PATH
的目录中。
流程
您还可以通过进入到 Serverless 客户端下载镜像 中的相应目录来下载任何
kn
版本。- 使用 ZIP 程序解压存档。
-
将
kn
二进制文件移到PATH
中的目录中。 要查看您的
PATH
,请打开命令窗口并运行以下命令:C:\> path