Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

第 9 章 Knative Serving

9.1. 使用 kn 完成 Serving 任务
复制链接

Knative CLI (kn) 会扩展 oc 或 kubectl 工具的功能，以支持在 OpenShift Container Platform 上与 Knative 组件交互。kn 允许开发人员在不直接编辑 YAML 文件的情况下部署和管理应用程序。

9.1.1. 使用 kn 的基本工作流
复制链接

以下基本流程部署了一个简单的 hello 服务，它会读环境变量 RESPONSE 并打印它的输出。

您可以使用本指南作为在服务中执行创建、读取、更新和删除（CRUD）操作的参考。

流程

  1. 通过一个镜像，在 default 命名空间内创建一个服务： 

    $ kn service create hello --image docker.io/openshift/hello-openshift --env RESPONSE="Hello Serverless!"
    Copy to Clipboard Toggle word wrap 
    Creating service 'hello' in namespace 'default':

  0.085s The Route is still working to reflect the latest desired specification.
  0.101s Configuration "hello" is waiting for a Revision to become ready.
 11.590s ...
 11.650s Ingress has not yet been reconciled.
 11.726s Ready to serve.

Service 'hello' created with latest revision 'hello-gsdks-1' and URL:
http://hello-default.apps-crc.testing
    Copy to Clipboard Toggle word wrap

  2. 列出服务： 

    $ kn service list
    Copy to Clipboard Toggle word wrap 
    NAME    URL                                     LATEST          AGE     CONDITIONS   READY   REASON
hello   http://hello-default.apps-crc.testing   hello-gsdks-1   8m35s   3 OK / 3     True
    Copy to Clipboard Toggle word wrap

  3. 使用 curl 服务端点命令检查该服务是否正在工作： 

    $ curl http://hello-default.apps-crc.testing
    Copy to Clipboard Toggle word wrap 
    Hello Serverless!
    Copy to Clipboard Toggle word wrap

  4. 更新服务： 

    $ kn service update hello --env RESPONSE="Hello OpenShift!"
    Copy to Clipboard Toggle word wrap 
    Updating Service 'hello' in namespace 'default':

 10.136s Traffic is not yet migrated to the latest revision.
 10.175s Ingress has not yet been reconciled.
 10.348s Ready to serve.

Service 'hello' updated with latest revision 'hello-dghll-2' and URL:
http://hello-default.apps-crc.testing
    Copy to Clipboard Toggle word wrap

    该服务的环境变量 RESPONSE 现在设置为 "Hello OpenShift!"。

  5. 描述该服务。 

    $ kn service describe hello
    Copy to Clipboard Toggle word wrap 
    Name:       hello
Namespace:  default
Age:        13m
URL:        http://hello-default.apps-crc.testing

Revisions:
  100%  @latest (hello-dghll-2) [2] (1m)
        Image:  docker.io/openshift/hello-openshift (pinned to 5ea96b)

Conditions:
  OK TYPE                   AGE REASON
  ++ Ready                   1m
  ++ ConfigurationsReady     1m
  ++ RoutesReady             1m
    Copy to Clipboard Toggle word wrap

  6. 删除服务： 

    $ kn service delete hello
    Copy to Clipboard Toggle word wrap 
    Service 'hello' successfully deleted in namespace 'default'.
    Copy to Clipboard Toggle word wrap

  7. 使用 list 命令来验证 hello 服务是否已被删除。 

    $ kn service list hello
    Copy to Clipboard Toggle word wrap 
    No services found.
    Copy to Clipboard Toggle word wrap

9.1.2. 使用 kn 自动扩展工作流
复制链接

您可使用 kn 修改 Knative 服务来访问自动扩展功能，而无需直接编辑 YAML 文件。

使用带有适当标志的 service create 和 service update 命令来配置自动扩展行为。

Expand
标志描述

--concurrency-limit int

单个副本处理的并发请求的硬性限制。

--concurrency-target int

根据传入请求的并发数量建议扩展时间。默认为 --concurrency-limit。

--max-scale int

最大副本数。

--min-scale int

最小副本数。

9.1.3. 使用 kn 进行流量分割
复制链接

kn 可帮助您控制哪些修订版本可获取您的 Knative 服务上的路由流量。

Knative 服务支持流量映射，可将服务的修订版本映射到流量的分配部分。它提供了为特定修订版本创建唯一 URL 的选项，且能够为最新修订版本分配流量。

每次更新服务配置时，都会创建一个新修订版本，服务路由默认会将所有流量指向最新可用的修订版本。

您可通过定义哪个修订版本可获得部分流量来更改此行为。

流程

  • 使用带有 --traffic 标志的 kn service update 命令来更新流量。
注意

--traffic RevisionName=Percent 使用以下语法：

  • --traffic 标志需要用等号 (=) 分隔的两个值。
  • RevisionName 字符串表示修订版本的名称。
  • Percent 整数表示分配给修订版本的流量部分。
  • 将标识符 @latest 用于 RevisionName，以表示服务的最新的可用修订版本。此标识符仅可与 --traffic 标志一起使用一次。
  • 如果 service update 命令更新该服务的配置值和流量标志，则 @latest 引用将指向更新应用到的所创建修订版本。
  • --traffic 标志可多次指定，且仅在所有标志的 Percent 值总和达到 100 时才有效。
注意

例如，要在放置所有流量前将 10％ 的流量路由至您的新修订版本，请使用以下命令： 

$ kn service update svc --traffic @latest=10 --traffic svc-vwxyz=90
Copy to Clipboard Toggle word wrap

9.1.3.1. 分配标签修订
复制链接

服务流量块中的标签会创建自定义 URL，指向引用的修订版本。用户可为服务的可用修订版本定义唯一标签，该标签通过使用 http(s)://TAG-SERVICE.DOMAIN 格式创建自定义 URL。

给定标签对于该服务的流量块来说必须唯一。kn 作为 kn service update 命令的一部分，支持为服务修订版本分配和取消分配自定义标签。

注意

如果您为特定修订版本分配了标签，用户便可通过 --traffic 标志中作为 --traffic Tag=Percent 的标签来引用修订版本。

流程

  • 输入命令： 

    $ kn service update svc --tag @latest=candidate --tag svc-vwxyz=current
    Copy to Clipboard Toggle word wrap
注意

--tag RevisionName=Tag 使用以下语法：

  • --tag 标志需要两个以 = 分隔的值。
  • RevisionName 字符串表示 Revision 的名称。
  • Tag 字符串表示要为此修订版本提供的自定义标签。
  • 将标识符 @latest 用于 RevisionName，以表示服务的最新的可用修订版本。此标识符仅可与 --tag 标志一起使用一次。
  • 如果 service update 命令更新该服务的配置值（以及标签标志），则 @latest 引用将在应用更新后指向所创建修订版本。
  • --tag 标志可多次指定。
  • --tag 标志可为同一修订版本分配不同标签。

9.1.3.2. 取消分配标签修订版本
复制链接

已分配至流量块中修订版本的标签可取消分配。取消分配标签将会移除自定义 URL。

注意

如果修订版本未标记，也没有为其分配流量，则会从流量块中完全移除该修订版本。

流程

  • 取消分配标签： 

    $ kn service update svc --untag candidate
    Copy to Clipboard Toggle word wrap
注意

--untag Tag 使用以下语法：

  • --untag 标志需要一个值。
  • tag 字符串表示服务流量块中的唯一标签需要取消分配。这也会移除对应的自定义 URL。
  • --untag 标志可多次指定。

9.1.3.3. 流量标志操作优先级
复制链接

所有流量相关标志均可使用一条 kn service update 命令指定。kn 定义这些标志的优先级。不考虑使用命令时指定的标志顺序。

通过 kn 评估标志时，标志的优先级如下：

  1. --untag：带有此标志的所有引用修订版本均将从流量块中移除。
  2. --tag：修订版本将按照流量块中的指定进行标记。
  3. --traffic：为引用的修订版本分配一部分流量分割。

9.1.3.4. 流量分割标志
复制链接

kn 作为 kn service update 命令的一部分，支持在服务的流量块上进行流量操作。

下表显示流量分割标志、值格式和标志执行的操作汇总。“重复”列表示在 kn service update 命令中可否重复标志特定值。

Expand
标志值操作重复

--traffic

RevisionName=Percent

为 RevisionName 提供 Percent 的流量

是

--traffic

Tag=Percent

为具有 Tag 的修订版本提供 Percent 的流量

是

--traffic

@latest=Percent

为最新可用的修订版本提供 Percent 的流量

否

--tag

RevisionName=Tag

为 RevisionName 提供 Tag

是

--tag

@latest=Tag

为最新可用的修订版本提供 Tag

否

--untag

Tag

从修订版本中移除 Tag

是

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat