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 |
控制器最后处理的服务的“代”。 | 可选 |
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
合同
这会导致在 subject
上设置 K_CE_OVERRIDES
环境变量,如下所示
{ "extensions": { "extra": "this is an extra attribute", "additional": "42" } }