13.7. PTP 硬件快速事件通知框架

1. DU 应用程序请求一个订阅：DU 将 API 请求发送到 cloud-event-proxy sidecar 以创建 PTP 事件订阅。cloud-event-proxy sidecar 创建一个订阅资源。
2. cloud-event-proxy sidecar 创建订阅： 事件资源由 cloud-event-proxy sidecar 保留。cloud-event-proxy sidecar 容器发送带有 ID 和 URL 位置的确认，以访问存储的订阅资源。sidecar 为订阅中指定的资源创建一个 AMQ 消息传递监听程序协议。
3. DU 应用程序接收 PTP 事件通知 ： cloud-event-proxy sidecar 容器侦听资源限定器中指定的地址。DU 事件消费者处理消息并将其传递到订阅中指定的返回 URL。
4. cloud-event-proxy sidecar 验证 PTP 事件并将其发布到 DU 应用程序： cloud-event-proxy sidecar 接收事件，解封云事件对象以检索数据，并获取返回 URL 以将事件发回到 DU 消费者应用程序。
5. DU 应用程序使用 PTP 事件： DU 应用程序事件消费者接收和处理 PTP 事件。

验证

1. 检查 AMQ Interconnect Operator 是否可用，且所需的 pod 是否正在运行：

   $ oc get pods -n amq-interconnect

   输出示例

   NAME                                    READY   STATUS    RESTARTS   AGE
   amq-interconnect-645db76c76-k8ghs       1/1     Running   0          23h
   interconnect-operator-5cb5fc7cc-4v7qm   1/1     Running   0          23h

2. 检查所需的 linuxptp-daemon PTP 事件制作者 pod 是否在 openshift-ptp 命名空间中运行。

   $ oc get pods -n openshift-ptp

   输出示例

   NAME                     READY   STATUS    RESTARTS       AGE
   linuxptp-daemon-2t78p    3/3     Running   0              12h
   linuxptp-daemon-k8n88    3/3     Running   0              12h

流程

1. 修改默认 PTP Operator 配置以启用 PTP 快速事件。

   1. 在 ptp-operatorconfig.yaml 文件中保存以下 YAML：

      apiVersion: ptp.openshift.io/v1
      kind: PtpOperatorConfig
      metadata:
        name: default
        namespace: openshift-ptp
      spec:
        daemonNodeSelector:
          node-role.kubernetes.io/worker: ""
        ptpEventConfig:
          enableEventPublisher: true 1
          transportHost: amqp://<instance_name>.<namespace>.svc.cluster.local 2

      1

      将 enableEventPublisher 设置为 true 以启用 PTP 快速事件通知。

      2

      将 transportHost 设置为您配置的 AMQ 路由器，其中 <instance_name> 和 <namespace> 对应于 AMQ Interconnect 路由器实例名称和命名空间，如 amqp://amq-interconnect.amq-interconnect.svc.cluster.local

   2. 更新 PtpOperatorConfig CR：

      $ oc apply -f ptp-operatorconfig.yaml

2. 为 PTP 启用接口创建 PtpConfig 自定义资源(CR)，并设置 ptpClockThreshold 和 ptp4lOpts 所需的值。以下 YAML 演示了您必须在 PtpConfig CR 中设置的必要值：

   spec:
     profile:
     - name: "profile1"
       interface: "enp5s0f0"
       ptp4lOpts: "-2 -s --summary_interval -4" 1
       phc2sysOpts: "-a -r -m -n 24 -N 8 -R 16" 2
       ptp4lConf: "" 3
     ptpClockThreshold: 4
       holdOverTimeout: 5
       maxOffsetThreshold: 100
       minOffsetThreshold: -100

   1

   附加 --summary_interval -4 以使用 PTP 快速事件。

   2

   所需的 phc2sysOpts 值。-m 将消息输出到 stdout。linuxptp-daemon DaemonSet 解析日志并生成 Prometheus 指标。

   3

   指定包含配置来替换默认 /etc/ptp4l.conf 文件的字符串。要使用默认配置，请将字段留空。

   4

   可选的。如果 ptpClockThreshold 小节不存在，则默认值用于 ptpClockThreshold 字段。小节显示默认的 ptpClockThreshold 值。ptpClockThreshold 值配置 PTP master 时钟在触发 PTP 事件前的时长。holdOverTimeout 是在 PTP master clock 断开连接时，PTP 时钟事件状态更改为 FREERUN 前的时间值（以秒为单位）。maxOffsetThreshold 和 minOffsetThreshold 设置以纳秒为单位，它们与 CLOCK_REALTIME (phc2sys) 或 master 偏移 (ptp4l) 的值进行比较。当 ptp4l 或 phc2sys 偏移值超出这个范围时，PTP 时钟状态被设置为 FREERUN。当偏移值在这个范围内时，PTP 时钟状态被设置为 LOCKED。

流程

1. 获取活跃的 linuxptp-daemon pod 列表。

   $ oc get pods -n openshift-ptp

   输出示例

   NAME                    READY   STATUS    RESTARTS   AGE
   linuxptp-daemon-2t78p   3/3     Running   0          8h
   linuxptp-daemon-k8n88   3/3     Running   0          8h

2. 运行以下命令，访问所需 cloud-event-proxy 容器的指标：

   $ oc exec -it <linuxptp-daemon> -n openshift-ptp -c cloud-event-proxy -- curl 127.0.0.1:9091/metrics

   其中：

   <linuxptp-daemon>

   指定您要查询的 pod，例如 linuxptp-daemon-2t78p。

   输出示例

   # HELP cne_amqp_events_published Metric to get number of events published by the transport
   # TYPE cne_amqp_events_published gauge
   cne_amqp_events_published{address="/cluster/node/compute-1.example.com/ptp/status",status="success"} 1041
   # HELP cne_amqp_events_received Metric to get number of events received  by the transport
   # TYPE cne_amqp_events_received gauge
   cne_amqp_events_received{address="/cluster/node/compute-1.example.com/ptp",status="success"} 1019
   # HELP cne_amqp_receiver Metric to get number of receiver created
   # TYPE cne_amqp_receiver gauge
   cne_amqp_receiver{address="/cluster/node/mock",status="active"} 1
   cne_amqp_receiver{address="/cluster/node/compute-1.example.com/ptp",status="active"} 1
   cne_amqp_receiver{address="/cluster/node/compute-1.example.com/redfish/event",status="active"}
   ...

流程

1. 输入以下命令从 cloud-event-proxy sidecar 容器返回可用 PTP 指标列表：

   $ oc exec -it <linuxptp_daemon_pod> -n openshift-ptp -c cloud-event-proxy -- curl 127.0.0.1:9091/metrics

   其中：

   <linuxptp_daemon_pod>

   指定您要查询的 pod，例如 linuxptp-daemon-2t78p。

2. 从返回的指标列表中复制您要查询的 PTP 指标名称，例如 cne_amqp_events_received。
3. 在 OpenShift Container Platform web 控制台中点 Observe Metrics。
4. 将 PTP 指标粘贴到 Expression 字段中，点 Run query。