流程

1. 在 Web 控制台中，导航到 Operators → OperatorHub 页面。
2. 滚动页面，或在 Filter by keyword 框中输入关键字 Serverless 来查找 OpenShift Serverless Operator。
3. 查看 Operator 信息并单击 Install。

4. 在 Install Operator 页面中：

   1. Installation Mode 是 All namespaces on the cluster (default) 。此模式将 Operator 安装至默认 openshift-serverless 命名空间，以便供集群中的所有命名空间监视和使用。
   2. 安装的命名空间 是 openshift-serverless。

   3. 选择一个 Update Channel。

      • stable 频道启用 OpenShift Serverless Operator 最新稳定版本的安装。stable 频道是默认值。
      • 要安装另一个版本，请指定对应的 stable-x.y 频道，如 stable-1.29。
   4. 选择 stable 频道作为 更新频道。stable 频道将启用 OpenShift Serverless Operator 最新稳定版本的安装。
   5. 选择 Automatic 或 Manual 批准策略。
5. 点 Install 使 Operator 可供 OpenShift Container Platform 集群上的所选命名空间使用。

6. 在 Catalog → Operator Management 页面中，您可以监控 OpenShift Serverless Operator 订阅的安装和升级进度。

   1. 如果选择了 Manual 批准策略，订阅的升级状态将会一直保持在 Upgrading，直到您审阅并批准了它的安装计划。在 Install Plan 页面批准后，订阅的升级状态将变为 Up to date。
   2. 如果选择了 Automatic 批准策略，升级状态会在不用人工参与的情况下变为 Up to date。

1. 切换到 Catalog → Operator Management 页，检查 Operator Subscriptions 和 Install Plans 页中的 Status 是否有错误。
2. 检查 Workloads → Pods 页中提供的关于openshift-serverless 项目中的 pod 的日志信息，以便进一步排除故障。

流程

1. 创建包含 Namespace、OperatorGroup 和 Subscription 对象的 YAML 文件，以便为 OpenShift Serverless Operator 订阅命名空间。例如，使用以下内容创建文件 serverless-subscription.yaml ：

   订阅示例

   ---
   apiVersion: v1
   kind: Namespace
   metadata:
     name: openshift-serverless
   ---
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: serverless-operators
     namespace: openshift-serverless
   spec: {}
   ---
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: serverless-operator
     namespace: openshift-serverless
   spec:
     channel: stable 1
     name: serverless-operator 2
     source: redhat-operators 3
     sourceNamespace: openshift-marketplace 4

   1

   Operator 的频道名称。stable 频道启用 OpenShift Serverless Operator 最新稳定版本的安装。要安装另一个版本，请指定对应的 stable-x.y 频道，如 stable-1.29。

   2

   要订阅的 Operator 的名称。对于 OpenShift Serverless Operator，这始终为 serverless-operator。

   3

   提供 Operator 的 CatalogSource 的名称。将 redhat-operators 用于默认的 OperatorHub 目录源。

   4

   CatalogSource 的命名空间。将 openshift-marketplace 用于默认的 OperatorHub 目录源。

2. 创建 Subscription 对象：

   $ oc apply -f serverless-subscription.yaml

流程

1. 从 Command Line Tools 页面下载 Knative (kn) CLI。您可以点 web 控制台右上角的 图标进入 Command Line Tools 页，并在列表中选择 Command Line Tools。

2. 解包存档：

   $ tar -xf <file>

3. 将 kn 二进制文件移到 PATH 中的目录中。

4. 运行以下命令可以查看 PATH 的值：

   $ echo $PATH

流程

1. 使用 Red Hat Subscription Manager 注册：

   # subscription-manager register

2. 获取最新的订阅数据：

   # subscription-manager refresh

3. 将订阅附加到注册的系统：

   # subscription-manager attach --pool=<pool_id> 1

   1

   活跃的 OpenShift Container Platform 订阅的池 ID

4. 启用 Knative (kn) CLI 所需的仓库：

   • Linux (x86_64, amd64)

     # subscription-manager repos --enable="openshift-serverless-1-for-rhel-8-x86_64-rpms"

   • Linux on IBM zSystems 和 IBM® 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"

5. 使用软件包管理器将 Knative (kn) CLI 作为 RPM 安装：

   yum 命令示例

   # yum install openshift-serverless-clients

流程

1. 为 DNF 软件包管理器安装 versionlock 插件：

   # dnf install 'dnf-command(versionlock)'

2. 运行以下命令来锁定 kn 版本：

   # dnf versionlock add --raw 'openshift-serverless-clients-1.7.*'

   此命令会将 kn 锁为基于 Knative 1.7 的版本，它在 OpenShift Serverless 1.29 发布时处于维护阶段。

流程

1. 检查升级的软件包是否可用：

   # dnf search --showduplicates openshift-serverless-clients

2. 删除 kn 的版本锁定：

1. 将 kn 锁定到新版本：

1. 升级到新的可用版本：

   # dnf install --upgrade openshift-serverless-clients

流程

1. 下载相关的 Knative (kn) CLI tar.gz 存档：

   • Linux (x86_64, amd64)
   • Linux on IBM zSystems 和 IBM® LinuxONE (s390x)
   • Linux on IBM Power (ppc64le)

   您还可以通过进入到 Serverless 客户端下载镜像 中的相应目录来下载任何 kn 版本。

2. 解包存档：

   $ tar -xf <filename>

3. 将 kn 二进制文件移到 PATH 中的目录中。

4. 运行以下命令可以查看 PATH 的值：

   $ echo $PATH

流程

1. 下载 Knative (kn) CLI tar.gz 存档。

   您还可以通过进入到 Serverless 客户端下载镜像 中的相应目录来下载任何 kn 版本。

2. 解包并提取存档。
3. 将 kn 二进制文件移到 PATH 中的目录中。

4. 要查看 PATH，打开终端窗口并运行：

   $ echo $PATH

流程

1. 下载 Knative (kn) CLI ZIP 存档。

   您还可以通过进入到 Serverless 客户端下载镜像 中的相应目录来下载任何 kn 版本。

2. 使用 ZIP 程序解压存档。
3. 将 kn 二进制文件移到 PATH 中的目录中。

4. 要查看您的 PATH，请打开命令窗口并运行以下命令：

   C:\> path

流程

1. 在 OpenShift Container Platform web 控制台的 Administrator 视角中，进入 Operators → Installed Operators。
2. 检查页面顶部的 Project 下拉菜单是否已设置为 Project: knative-serving。
3. 点 OpenShift Serverless Operator 的 Provided APIs 列表中的 Knative Serving 来进入 Knative Serving 选项卡。
4. 点 Create Knative Serving。

5. 在 Create Knative Serving 页中，您可以使用默认设置安装 Knative Serving。点 Create。

   您还可以使用提供的表单或编辑 YAML 来修改 KnativeServing 对象来修改 Knative Serving 安装的设置。

   • 建议您在不需要完全控制 KnativeServing 对象创建的简单配置中使用该表单。

   • 对于更复杂的配置，建议编辑 YAML，这可以完全控制 KnativeServing 对象的创建。您可以通过点 Create Knative Serving 页右上角的 edit YAML 链接来访问 YAML。

     完成表单后，或者完成对 YAML 的修改后，点 Create。

     注意

     如需有关 KnativeServing 自定义资源定义的配置选项的更多信息，请参阅高级安装配置选项。

6. 安装 Knative Serving 后，会创建 KnativeServing 对象，并自动定向到 Knative Serving 选项卡。您可以在资源列表中看到 knative-serving 自定义资源。

验证

1. 在 Knative Serving 选项卡中点 knative-serving 自定义资源。

2. 您将被自动定向到 Knative Serving Overview 页面。

   
3. 向下滚动查看条件列表。

4. 您应该看到一个状况为 True 的条件列表，如示例镜像所示。

   
   注意

   创建 Knative Serving 资源可能需要几秒钟时间。您可以在 Resources 选项卡中查看其状态。

5. 如果条件状态为 Unknown 或 False，请等待几分钟，然后在确认已创建资源后再重新检查。

流程

1. 创建名为 serving.yaml 的文件并将以下示例 YAML 复制到其中：

   apiVersion: operator.knative.dev/v1beta1
   kind: KnativeServing
   metadata:
       name: knative-serving
       namespace: knative-serving

2. 应用 service.yaml 文件：

   $ oc apply -f serving.yaml

验证

1. 使用以下命令校验安装是否完成：

   $ oc get knativeserving.operator.knative.dev/knative-serving -n knative-serving --template='{{range .status.conditions}}{{printf "%s=%s\n" .type .status}}{{end}}'

   输出示例

   DependenciesInstalled=True
   DeploymentsAvailable=True
   InstallSucceeded=True
   Ready=True

   注意

   创建 Knative Serving 资源可能需要几秒钟时间。

   如果条件状态为 Unknown 或 False，请等待几分钟，然后在确认已创建资源后再重新检查。

2. 检查是否已创建 Knative Serving 资源：

   $ oc get pods -n knative-serving

   输出示例

   NAME                                                        READY   STATUS      RESTARTS   AGE
   activator-67ddf8c9d7-p7rm5                                  2/2     Running     0          4m
   activator-67ddf8c9d7-q84fz                                  2/2     Running     0          4m
   autoscaler-5d87bc6dbf-6nqc6                                 2/2     Running     0          3m59s
   autoscaler-5d87bc6dbf-h64rl                                 2/2     Running     0          3m59s
   autoscaler-hpa-77f85f5cc4-lrts7                             2/2     Running     0          3m57s
   autoscaler-hpa-77f85f5cc4-zx7hl                             2/2     Running     0          3m56s
   controller-5cfc7cb8db-nlccl                                 2/2     Running     0          3m50s
   controller-5cfc7cb8db-rmv7r                                 2/2     Running     0          3m18s
   domain-mapping-86d84bb6b4-r746m                             2/2     Running     0          3m58s
   domain-mapping-86d84bb6b4-v7nh8                             2/2     Running     0          3m58s
   domainmapping-webhook-769d679d45-bkcnj                      2/2     Running     0          3m58s
   domainmapping-webhook-769d679d45-fff68                      2/2     Running     0          3m58s
   storage-version-migration-serving-serving-0.26.0--1-6qlkb   0/1     Completed   0          3m56s
   webhook-5fb774f8d8-6bqrt                                    2/2     Running     0          3m57s
   webhook-5fb774f8d8-b8lt5                                    2/2     Running     0          3m57s

3. 检查所需的网络组件是否已安装到自动创建的 knative-serving-ingress 命名空间：

   $ oc get pods -n knative-serving-ingress

   输出示例

   NAME                                      READY   STATUS    RESTARTS   AGE
   net-kourier-controller-7d4b6c5d95-62mkf   1/1     Running   0          76s
   net-kourier-controller-7d4b6c5d95-qmgm2   1/1     Running   0          76s
   3scale-kourier-gateway-6688b49568-987qz   1/1     Running   0          75s
   3scale-kourier-gateway-6688b49568-b5tnp   1/1     Running   0          75s

流程

1. 在 OpenShift Container Platform web 控制台的 Administrator 视角中，进入 Operators → Installed Operators。
2. 检查页面顶部的 Project 下拉菜单是否已设置为 Project: knative-eventing。
3. 点 OpenShift Serverless Operator 的 Provided APIs 列表中的 Knative Eventing 来进入 Knative Eventing 选项卡。
4. 点 Create Knative Eventing。

5. 在 Create Knative Eventing 页面中，您可以选择使用提供的默认表单或编辑 YAML 来配置 KnativeEventing 对象。

   • 建议您在不需要完全控制 KnativeEventing 对象创建的简单配置中使用该表单。

     可选。如果您要使用表单配置 KnativeEventing 对象，请为您的 Knative Eventing 部署进行任何要实现的更改。

6. 点 Create。

   • 对于更复杂的配置，建议编辑 YAML，这可以完全控制 KnativeEventing 对象的创建。您可以通过点 Create Knative Eventing 页右上角的 edit YAML 链接来访问 YAML。

     可选。如果您要通过编辑 YAML 配置 KnativeEventing 对象，请对您希望用于 Knative Eventing 部署的 YAML 进行更改。

7. 点 Create。
8. 安装 Knative Eventing 后，会创建 KnativeEventing 对象，并自动定向到 Knative Eventing 选项卡。您可以在资源列表中看到 knative-eventing 自定义资源。

验证

1. 点 Knative Eventing 选项卡中的 knative-eventing 自定义资源。

2. 您会自动定向到 Knative Eventing Overview 页面。

   
3. 向下滚动查看条件列表。

4. 您应该看到一个状况为 True 的条件列表，如示例镜像所示。

   
   注意

   创建 Knative Eventing 资源可能需要几秒钟时间。您可以在 Resources 选项卡中查看其状态。

5. 如果条件状态为 Unknown 或 False，请等待几分钟，然后在确认已创建资源后再重新检查。

流程

1. 创建名为 eventing.yaml 的文件。

2. 将以下示例 YAML 复制到 eventing.yaml中：

   apiVersion: operator.knative.dev/v1beta1
   kind: KnativeEventing
   metadata:
       name: knative-eventing
       namespace: knative-eventing

3. 可选。根据您的 Knative Eventing 部署，对 YAML 进行相应的更改。

4. 输入以下内容来应用 eventing.yaml 文件：

   $ oc apply -f eventing.yaml

验证

1. 输入以下命令验证安装是否完成，并观察输出结果：

   $ oc get knativeeventing.operator.knative.dev/knative-eventing \
     -n knative-eventing \
     --template='{{range .status.conditions}}{{printf "%s=%s\n" .type .status}}{{end}}'

   输出示例

   InstallSucceeded=True
   Ready=True

   注意

   创建 Knative Eventing 资源可能需要几秒钟时间。

2. 如果条件状态为 Unknown 或 False，请等待几分钟，然后在确认已创建资源后再重新检查。

3. 使用以下命令检查是否已创建 Knative Eventing 资源：

   $ oc get pods -n knative-eventing

   输出示例

   NAME                                   READY   STATUS    RESTARTS   AGE
   broker-controller-58765d9d49-g9zp6     1/1     Running   0          7m21s
   eventing-controller-65fdd66b54-jw7bh   1/1     Running   0          7m31s
   eventing-webhook-57fd74b5bd-kvhlz      1/1     Running   0          7m31s
   imc-controller-5b75d458fc-ptvm2        1/1     Running   0          7m19s
   imc-dispatcher-64f6d5fccb-kkc4c        1/1     Running   0          7m18s

验证

1. 点 Knative Kafka 选项卡中的 knative-kafka 资源。您会自动定向到 Knative Kafka Overview 页面。

2. 查看资源的 Conditions 列表，并确认其状态为 True。

   

   如果条件的状态为 Unknown 或 False，请等待几分钟刷新页面。

3. 检查是否已创建 Apache Kafka 资源的 Knative 代理：

   $ oc get pods -n knative-eventing

   输出示例

   NAME                                        READY   STATUS    RESTARTS   AGE
   kafka-broker-dispatcher-7769fbbcbb-xgffn    2/2     Running   0          44s
   kafka-broker-receiver-5fb56f7656-fhq8d      2/2     Running   0          44s
   kafka-channel-dispatcher-84fd6cb7f9-k2tjv   2/2     Running   0          44s
   kafka-channel-receiver-9b7f795d5-c76xr      2/2     Running   0          44s
   kafka-controller-6f95659bf6-trd6r           2/2     Running   0          44s
   kafka-source-dispatcher-6bf98bdfff-8bcsn    2/2     Running   0          44s
   kafka-webhook-eventing-68dc95d54b-825xs     2/2     Running   0          44s

流程

1. 在 ${XDG_RUNTIME_DIR}/podman/podman.sock 的 UNIX 套接字上启动提供 Docker API 的 Podman 服务：

   $ systemctl start --user podman.socket

   注意

   在大多数系统中，此套接字位于 /run/user/$ (id -u) /podman/podman.sock。

2. 建立用于构建功能的环境变量：

   $ export DOCKER_HOST="unix://${XDG_RUNTIME_DIR}/podman/podman.sock"

3. 在函数项目目录中使用 -v 标记运行构建命令，以查看详细的输出。您应该看到到本地 UNIX 套接字的连接：

   $ kn func build -v

流程

1. 创建 Podman 机器：

   $ podman machine init --memory=8192 --cpus=2 --disk-size=20

2. 启动 Podman 机器，该机器在 UNIX 套接字上提供 Docker API：

   $ podman machine start
   Starting machine "podman-machine-default"
   Waiting for VM ...
   Mounting volume... /Users/myuser:/Users/user
   
   [...truncated output...]
   
   You can still connect Docker API clients by setting DOCKER_HOST using the
   following command in your terminal session:
   
   	export DOCKER_HOST='unix:///Users/myuser/.local/share/containers/podman/machine/podman-machine-default/podman.sock'
   
   Machine "podman-machine-default" started successfully

   注意

   在大多数 macOS 系统上，此套接字位于 /Users/myuser/.local/share/containers/podman/machine/podman-machine-default/podman.sock。

3. 建立用于构建功能的环境变量：

   $ export DOCKER_HOST='unix:///Users/myuser/.local/share/containers/podman/machine/podman-machine-default/podman.sock'

4. 在函数项目目录中使用 -v 标记运行构建命令，以查看详细的输出。您应该看到到本地 UNIX 套接字的连接：

   $ kn func build -v

流程

1. 通过在 OpenShift Serverless 发行注记中搜索最初安装的 OpenShift Serverless Operator 版本。

   例如，尝试升级过程中的错误消息可能包含以下字符串：

   The installed KnativeServing version is v1.5.0.

   在本例中，KnativeServing MAJOR.MINOR 版本为 1.5，它已在 OpenShift Serverless 1.26 的发行注记中介绍：OpenShift Serverless 现在使用 Knative Serving 1.5。

2. 卸载 OpenShift Serverless Operator 及其所有安装计划。

3. 手动安装您在第一步中发现的 OpenShift Serverless Operator 版本。要安装，首先创建一个 serverless-subscription.yaml 文件，如下例所示：

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: serverless-operator
     namespace: openshift-serverless
   spec:
     channel: stable
     name: serverless-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     installPlanApproval: Manual
     startingCSV: serverless-operator.v1.26.0

4. 然后，运行以下命令来安装订阅：

   $ oc apply -f serverless-subscription.yaml

5. 在出现升级时手动批准升级安装计划进行升级。