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 |
已為來源配置的當前活動接收器 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" } }