PingSource 参考¶
本主题提供有关 PingSource 对象可配置字段的参考信息。
PingSource¶
PingSource 定义支持以下字段
| 字段 | 描述 | 必需或可选 |
|---|---|---|
apiVersion |
指定 API 版本,例如 sources.knative.dev/v1。 |
必需 |
kind |
将此资源对象标识为 PingSource 对象。 | 必需 |
metadata |
指定唯一标识 PingSource 对象的元数据。例如,name。 |
必需 |
spec |
指定此 PingSource 对象的配置信息。 | 必需 |
spec.contentType |
data 或 dataBase64 的媒体类型。默认为空。 |
可选 |
spec.data |
用作发送到接收器的事件主体的载荷。默认为空。与 dataBase64 互斥。 |
如果未发送 base64 编码数据,则为必填项 |
spec.dataBase64 |
发送到接收器的实际事件主体的 base64 编码字符串。默认为空。与 data 互斥。 |
如果发送 base64 编码数据,则为必填项 |
spec.schedule |
指定 cron 计划。默认为 * * * * *。 |
可选 |
spec.sink |
引用一个对象,该对象解析为用作接收器的 URI。 | 必需 |
spec.timezone |
相对于指定时区修改实际时间。默认为系统时区。 请参阅维基百科上有效的 tz 数据库时区列表。有关时区的一般信息,请参阅 IANA 网站。 |
可选 |
spec.ceOverrides |
定义覆盖,以控制发送到接收器的事件的输出格式和修改。 | 可选 |
status |
定义 PingSource 的观察状态。 | 可选 |
status.observedGeneration |
控制器最后处理的服务的“Generation”。 | 可选 |
status.conditions |
资源当前状态的最新可用观察结果。 | 可选 |
status.sinkUri |
为 Source 配置的当前活动接收器 URI。 | 可选 |
CloudEvent 覆盖¶
CloudEvent 覆盖定义了用于控制发送到接收器的事件的输出格式和修改的覆盖。
ceOverrides 定义支持以下字段
| 字段 | 描述 | 必需或可选 |
|---|---|---|
extensions |
指定哪些属性被添加到出站事件或被其覆盖。每个 extensions 键值对作为属性扩展独立地设置在事件上。 |
可选 |
注意
只允许使用有效的 CloudEvent 属性名称 作为扩展。您不能从扩展覆盖配置中设置规范定义的属性。例如,您不能修改 type 属性。
示例:CloudEvent 覆盖¶
apiVersion: sources.knative.dev/v1
kind: PingSource
metadata:
name: test-heartbeats
spec:
...
ceOverrides:
extensions:
extra: this is an extra attribute
additional: 42
契约
这将导致 K_CE_OVERRIDES 环境变量在 subject 上设置如下
{ "extensions": { "extra": "this is an extra attribute", "additional": "42" } }