第 4 章 Knative CLI
4.1. 安装 Knative CLI
Knative (kn
) CLI 本身没有登录机制。要登录到集群,您必须安装 OpenShift CLI (oc
),并使用 oc login
命令。CLI 的安装选项可能会因您的操作系统而异。
有关为您的操作系统安装 oc
CLI 并使用 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 版本以避免出现问题。
4.1.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
4.1.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
4.1.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
4.1.4. 为 macOS 安装 Knative CLI
如果使用 macOS,您可以将 Knative (kn
) CLI 安装为二进制文件。要做到这一点,您必须下载并解包一个 tar.gz
存档,并将二进制文件添加到 PATH
的目录中。
流程
下载 Knative (
kn
) CLItar.gz
存档。您还可以通过进入到 Serverless 客户端下载镜像 中的相应目录来下载任何
kn
版本。- 解包并提取存档。
-
将
kn
二进制文件移到PATH
中的目录中。 要查看
PATH
,打开终端窗口并运行:$ echo $PATH
4.1.5. 为 Windows 安装 Knative CLI
如果使用 Windows,您可以将 Knative (kn
) CLI 安装为二进制文件。要做到这一点,您必须下载并解包 ZIP 存档,并将二进制文件添加到 PATH
的目录中。
流程
您还可以通过进入到 Serverless 客户端下载镜像 中的相应目录来下载任何
kn
版本。- 使用 ZIP 程序解压存档。
-
将
kn
二进制文件移到PATH
中的目录中。 要查看您的
PATH
,请打开命令窗口并运行以下命令:C:\> path