Knative Service 深度解析:从对象模型到实战部署

原创2026-10-15 12:37:491,758 阅读
文章标签:文档教程云原生

Knative Service 深度解析:从对象模型到实战部署

本文以仓库文档 docs/versioned/serving/services/README.md 为主体,结合 Knative docs 仓库中的创建指南、流量管理与请求流转文档,以及 helloworld-go 示例代码,系统讲解 Knative Service 的核心概念、资源联动机制与实战配置方法。

Service 是什么:Knative 的部署入口

Knative Service(service.serving.knative.dev)是 Knative Serving 中用于部署应用的顶层抽象资源。与普通 Kubernetes Deployment 不同,你无需逐一管理 Deployment、Service、Ingress 等底层对象,只需提交一份定义 Service 的 YAML 文件即可。这份 YAML 需要承担三项职责:

  • 描述应用的元数据(metadata),例如名称与命名空间;
  • 指向应用托管镜像(hosted image)的地址;
  • 允许对 Service 进行配置(configuration),包括环境变量、资源限额等。

在 Knative 的对象模型中(参见 about-serving.md),Serving 定义了一组 Kubernetes Custom Resource Definitions(CRDs),而 Service 正是其中最顶层的编排者:

  • Service:自动管理工作负载的完整生命周期。它控制其他对象的创建,确保应用始终拥有 Route、Configuration,并且每次更新都会产生一个新 Revision。Service 既可以将流量始终导向最新 Revision(latestRevision),也可以钉住(pinned)到某个指定的 Revision。
  • Route(route.serving.knative.dev):将网络端点映射到一个或多个 Revision,支持分数流量(fractional traffic)和命名路由(named routes)等多种流量管理方式。
  • Configuration(configuration.serving.knative.dev):维护部署的期望状态,实现代码与配置的分离,遵循 Twelve-Factor App 方法论;修改 Configuration 即创建新 Revision。
  • Revision(revision.serving.knative.dev):工作负载每次修改时的"代码 + 配置"时间点快照。Revision 是不可变对象,可按需保留,并根据入站流量自动扩缩容。

你可以通过 kubectl apply 直接提交 Service YAML,也可以通过 kn service create 命令一行创建(详见 creating-services.md)。

Service、Route 与 Configuration 的三方联动

原文档指出:每个 Service 都由一个与之同名的 Route 和一个同名的 Configuration 构成。这两个对象并非由用户手动创建,而是由 Service 控制器(service controller)自动创建,其配置完全派生自 Service 自身的配置。

Service (serving.knative.dev/v1)
├── Configuration(与 Service 同名)
│   └── Revision(每次 Configuration 更新生成一个不可变快照)
└── Route(与 Service 同名)
    └── 将流量按规则转发到一个或多个 Revision

这样设计的价值在于职责分离:Configuration 只管"期望状态",Route 只管"流量分发",而 Service 则是二者之上的统一入口。部署一个应用时,Knative 会替你完成:

  1. 为当前版本的应用创建一个新的不可变 Revision;
  2. 进行网络编程(network programming),为应用创建 Route、Ingress、Kubernetes Service 与负载均衡器;
  3. 基于流量自动对 Pod 进行扩缩容,包括缩容到零个活跃 Pod(scale to zero)。

修改 Knative Service 的同步规则

这是原文档强调的核心运维约束。对 Service 的 spec、metadata 标签(labels)或 metadata 注解(annotations)所做的任何修改,都必须同步复制到其拥有的 Route 和 Configuration 上。具体规则如下:

  • Route 和 Configuration 上的 serving.knative.dev/service 标签必须设置为该 Service 的名称;
  • Route 和 Configuration 上任何未在上述规则中指定的额外标签或注解,都必须被移除。

也就是说,Service 对其下游对象采取的是"完全所有权"策略:标签与注解以 Service 为唯一事实来源,Controller 会清理下游对象上多余或过期的元数据。这一行为可以在源码层面得到印证——在调试输出中可以看到 Route 和 Configuration 被打上 serving.knative.dev/service: helloworld-go 这样的标签(参见 debugging-application-issues.md)。

同时,Service 会根据其所拥有的 Route 和 Configuration 的对应 status 值来更新自己的 status 字段。Service 的状态中除了通用的 Ready 条件外,必须包含 RoutesReady 和 ConfigurationsReady 这两个条件;其他条件也可以存在。这意味着一个 Service 的"就绪"是链路级的:Configuration 已就绪(产生了可用的 Revision)、Route 已就绪(流量拓扑已配置完成),两者都满足后 Service 才会整体进入 Ready 状态。

实战:创建你的第一个 Knative Service

仓库中的 creating-services.md 给出了完整的创建流程。前置条件包括:

以 helloworld-go 示例为例,有两种创建方式:

方式一:Apply YAML

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: helloworld-go
  namespace: default
spec:
  template:
    spec:
      containers:
        - image: ghcr.io/knative/helloworld-go:latest
          env:
            - name: TARGET
              value: "Go Sample v1"
kubectl apply -f <filename>.yaml

其中 <filename> 是上一步创建的 YAML 文件名。

方式二:kn CLI

kn service create helloworld-go --image ghcr.io/knative/helloworld-go:latest

创建成功后,Knative 会依次完成:创建新 Revision → 网络编程(Route、Ingress、Service、负载均衡器)→ 按流量自动扩缩容(可缩至零)。仓库中 code-samples/serving/hello-world/helloworld-go/service.yaml 提供了可直接运行的 Service 定义,示例应用源码 helloworld.go 读取 TARGET 环境变量并打印 Hello ${TARGET}!,未设置时默认输出 Hello World!。

底层原理:Service 背后的请求流转与扩缩容

Service 之所以能做到"创建即路由、按流量伸缩",依赖的是 Knative Serving 数据面的协调机制。仓库中的 request-flow.md 详细描述了 HTTP 请求的流转路径:

Knative Serving HTTP 请求流转图:从 HTTP 路由器经可选 Activator、queue-proxy 到用户容器

  • Scale From Zero:当某个 Revision 流量很低或为零时,HTTP 路由器将请求转给 Activator,并在请求中附加携带所选 Revision 的内部头部。Activator 作为缓冲队列暂存请求,同时向 Autoscaler 发出扩容信号;新 Pod 就绪或旧 Pod 有空闲容量后,Activator 才转发请求。若需要启动新 Pod 来承接请求,即为一次"冷启动"(cold-start)。
  • High Scale:当 Revision 流量较高(备用容量超过 target-burst-capacity)时,Ingress 路由器被直接编程为 Revision 的 Pod 地址,Activator 退出请求路径以降低延迟;但 queue-proxy 始终留在请求链路中。
  • Queue-Proxy 职责:为 Autoscaler 测量并发请求数、执行 containerConcurrency 硬限制、处理 Pod 终止时的优雅停机(拒绝新请求、通过失败就绪检查、继续服务存量请求),并上报 HTTP 指标与追踪信息。

Autoscaler 通过 target-burst-capacity、concurrency-target 等参数(详见 autoscaling)持续测量流量并调整 Pod 数量,这正是 Revision "基于 Kubernetes 资源按流量扩缩容"的实现基础。同时,Revision 是不可变对象,你不能直接创建或修改 Revision 的 spec——它总是在 Configuration spec 更新时被动生成(参见 about-revisions.md)。

高级配置:让 Service 适配真实业务

围绕 Service 的核心概念,仓库还提供了若干高频运维配置:

1. 资源请求与限制

可以在 Service 的 template.spec.containers 下为 CPU 与内存设置 requests 与 limits(详见 configure-requests-limits-services.md):

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: example-service
  namespace: default
spec:
  template:
    spec:
      containers:
        - image: docker.io/user/example-app
          resources:
            requests:
              cpu: 100m
              memory: 640M
            limits:
              cpu: 1

Queue Proxy(sidecar)的资源则可通过 queue.sidecar.serving.knative.dev/* 注解在 Service 级别设置,或在部署 ConfigMap 中全局设置(见 deployment.md)。

2. 私有服务(cluster-local)

默认情况下,未配置域名的 Service 使用 .svc.cluster.local 域名,属于集群内私有网络。若要为单个 Service 开启集群内可见性,可打上 networking.knative.dev/visibility=cluster-local 标签(详见 private-services.md):

kubectl label kservice helloworld-go networking.knative.dev/visibility=cluster-local

验证方式:

kubectl get kservice helloworld-go

输出中 URL 若为 http://helloworld-go.default.svc.cluster.local,即表示该 Service 仅集群内可达。

3. 自定义域名(DomainMapping)

你可以通过 DomainMapping 对象把自有域名(如 example.org)映射到某个 Knative Service,只需先将域名的 DNS 指向集群(详见 custom-domains.md)。创建前通常需要先申请 ClusterDomainClaim:

apiVersion: networking.internal.knative.dev/v1alpha1
kind: ClusterDomainClaim
metadata:
  name: <domain-name>
spec:
  namespace: <namespace>

随后创建 DomainMapping(serving.knative.dev/v1beta1),其 spec.ref 指向目标 Service,可选 tls.secretName 开启 HTTPS:

apiVersion: serving.knative.dev/v1beta1
kind: DomainMapping
metadata:
  name: <domain-name>
  namespace: <namespace>
spec:
  ref:
    name: <service-name>
    kind: Service
    apiVersion: serving.knative.dev/v1
  tls:
    secretName: <cert-secret>

也可以使用 kn domain create 命令,并通过 ksvc:/kroute: 前缀指定映射目标是 Service 还是 Route。

4. 流量管理与灰度发布

通过修改 Service 的 traffic spec,可以将流量按百分比拆给多个固定 Revision,或用 latestRevision: true 将流量导向最新 Revision(详见 traffic-management.md)。典型的蓝绿发布场景中,先让新 Revision 以 0% 流量上线(打上 tag 生成独立测试 URL),验证后再逐步将 50%、100% 流量切到新版本,实现安全的渐进式发布与回滚。

5. Queue Proxy 扩展(QPOptions)

如果你的集群使用了支持 QPOptions 的 Queue Proxy 镜像,还可以通过 qpoption.knative.dev/* 注解为单个 Service 激活并配置扩展(详见 using-queue-extensions.md),例如激活安全防护类扩展:

spec:
  template:
    metadata:
      annotations:
        features.knative.dev/queueproxy-podinfo: enabled
        qpoption.knative.dev/testgate-activate: enable
        qpoption.knative.dev/testgate-config-response: CU
        qpoption.knative.dev/testgate-config-sender: Joe

小结

Knative Service 是 Serving 体系中"一键部署 + 自动流量编排"的入口:它向下自动派生同名 Route 与 Configuration,后者每次变更生成不可变 Revision,Revision 依据流量自动扩缩容(可缩至零);向上则以 Ready、RoutesReady、ConfigurationsReady 三个条件对外暴露就绪状态。修改 Service 时,标签、注解与 spec 的同步规则是保证下游对象一致性的关键。掌握 Service 的对象模型、创建流程与高级配置,是理解并驾驭 Knative Serving 的第一步。

登录后查看全文
docs