Menu Close

5.8. 使用 ping 源

ping 源用于定期向事件消费者发送带有恒定有效负载的 ping 事件。

ping 源可以用来调度发送事件，类似于计时器。

ping 源 YAML 示例

apiVersion: sources.knative.dev/v1alpha2
kind: PingSource
metadata:
  name: test-ping-source
spec:
  schedule: "*/2 * * * *" 1
  jsonData: '{"message": "Hello world!"}' 2
  sink: 3
    ref:
      apiVersion: serving.knative.dev/v1
      kind: Service
      name: event-display

1
事件指定的调度使用 CRON 格式。
2
事件消息正文以 JSON 编码的数据字符串表示。
3
这些是事件消费者的详情。在这个示例中，我们使用名为 event-display 的 Knative 服务。

5.8.1. 使用 Developer 视角创建 ping 源

您可从 OpenShift Container Platform web 控制台创建和验证基本 ping 源。

先决条件

要使用 Developer 视角创建 ping 源，请确保：

  • OpenShift Serverless Operator、Knative Serving 和 Knative Eventing 已在 OpenShift Container Platform 集群中安装。
  • 已登陆到 web 控制台。
  • 处于 Developer 视角。
  • 您已创建了一个项目，或者具有适当的角色和权限访问项目，以便在 OpenShift Container Platform 中创建应用程序和其他工作负载。

流程

  1. 要验证 ping 源是否可以工作，请创建一个简单的 Knative 服务，在服务日志中转储传入的信息。

    1. 在 Developer 视角中，导航到 +Add → YAML。

    2. 复制 YAML 示例： 

      apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: event-display
spec:
  template:
    spec:
      containers:
        - image: quay.io/openshift-knative/knative-eventing-sources-event-display:latest
    3. 点击 Create。

  2. 在与上一步中创建的服务相同的命名空间中创建一个 ping 源，或您要将事件发送到的任何其他接收器。

    1. 在 Developer 视角中，导航到 +Add → Event Source。此时会显示 Event Sources 页面。
    2. 可选：如果您的事件源有多个供应商，请从 Providers 列表中选择所需的供应商，以过滤供应商的可用事件源。

    3. 选择 Ping Source，然后点击 Create Event Source。此时会显示 Create Event Source 页面。

      注意

      您可以使用 Form view 或 YAML view 配置 PingSource 设置，并可以在两者间切换。在不同视图间切换时数据会被保留。

    4. 为 Schedule 输入一个值。在本例中，值为 */2 * * *，它会创建一个 PingSource，每两分钟发送一条消息。
    5. 可选：您可以为 Data 输入一个值，它是消息的有效负载。
    6. 选择一个 Sink。这可以是 Resource 或一个 URI。在这个示例中，上一步中创建的 event-display 服务被用作 Resource sink。
    7. 点击 Create。

验证

您可以通过查看 Topology 页面来验证 ping 源是否已创建并连接到接收器。

  1. 在 Developer 视角中，导航到 Topology。

  2. 查看 ping 源和接收器。

    在 Topology 视图中查看 ping 源和服务