Knative Service 深度解析:从对象模型到实战部署
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 会替你完成:
- 为当前版本的应用创建一个新的不可变 Revision;
- 进行网络编程(network programming),为应用创建 Route、Ingress、Kubernetes Service 与负载均衡器;
- 基于流量自动对 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 给出了完整的创建流程。前置条件包括:
- 一个已安装 Knative Serving 的 Kubernetes 集群(安装方式见 install-serving-with-yaml.md);
- 可选:若要使用
kn service create,需先安装knCLI(见 configure-kn.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 请求的流转路径:
- 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 的第一步。
