4.15. 配置代理健康检查

流程

1. 编辑代理部署的 CR 实例。

   1. 使用 OpenShift 命令行界面：

      1. 以具有特权的用户身份登录 OpenShift Container Platform，以便在代理部署的项目中部署 CR。

      2. 编辑部署的 CR。

          oc edit ActiveMQArtemis <CR instance name> -n <namespace>

         Copy to Clipboard Toggle word wrap

   2. 使用 OpenShift Container Platform Web 控制台：

      1. 以具有特权的用户身份登录 OpenShift Container Platform，以便在代理部署的项目中部署 CR。
      2. 在左侧窗格中，单击 Administration Custom Resource Definitions。
      3. 单击 ActiveMQArtemis CRD。
      4. 点 实例 选项卡。
      5. 点代理部署的实例。

      6. 点 YAML 标签。

         在控制台中，会打开 YAML 编辑器，供您编辑 CR 实例。

2. 在 CR 的 deploymentPlan 部分中，添加一个 startupProbe 部分。例如：

   spec:
     deploymentPlan:
       startupProbe:
         exec:
           command:
             - /bin/bash
             - '-c'
             - /opt/amq/bin/artemis
             - 'check'
             - 'node'
             - '--up'
             - '--url'
             - 'tcp://$HOSTNAME:61616'
         initialDelaySeconds: 5
         periodSeconds: 10
         timeoutSeconds: 3
         failureThreshold: 30

   Copy to Clipboard Toggle word wrap

   命令

   在容器内运行的启动探测命令。在示例中，启动探测使用 artemis check node 命令来验证是否在容器中为代理 Pod 启动 AMQ Broker。

   initialDelaySeconds

   探测在容器启动后运行前的延迟（以秒为单位）。默认值为 0。

   periodSeconds

   探测运行的时间间隔（以秒为单位）。默认值为 10。

   timeoutSeconds

   启动探测命令等待代理回复的时间（以秒为单位）。如果没有收到对命令的响应，命令将被终止。默认值为 1。

   failureThreshold

   连续失败（包括探测被认为已失败）的启动探测的最小失败。当探测被视为失败时，它会重启 Pod。默认值为 3。

   根据集群的资源和代理日志的大小，您可能需要增加故障阈值，以允许代理有足够的时间启动并传递探测检查。否则，代理会输入一个循环条件，其中会重复达到失败阈值，代理每次由启动探测重启。例如，如果您将 failureThreshold 设置为 30，且探测的默认间隔为 10 秒，则代理有 300 秒才能启动并传递探测检查。

3. 保存 CR。

流程

1. 编辑代理部署的 CR 实例。

   1. 使用 OpenShift 命令行界面：

      1. 以具有特权的用户身份登录 OpenShift Container Platform，以便在代理部署的项目中部署 CR。

      2. 编辑部署的 CR。

          oc edit ActiveMQArtemis <CR instance name> -n <namespace>

         Copy to Clipboard Toggle word wrap

   2. 使用 OpenShift Container Platform Web 控制台：

      1. 以具有特权的用户身份登录 OpenShift Container Platform，以便在代理部署的项目中部署 CR。
      2. 在左侧窗格中，单击 Administration Custom Resource Definitions。
      3. 单击 ActiveMQArtemis CRD。
      4. 点 实例 选项卡。
      5. 点代理部署的实例。
      6. 点 YAML 标签。

2. 要配置存活度探测，请在 CR 的 deploymentPlan 部分中添加一个 livenessProbe 部分。例如：

   spec:
     deploymentPlan:
       livenessProbe:
         initialDelaySeconds: 5
         periodSeconds: 5
         failureThreshold: 30

   Copy to Clipboard Toggle word wrap

   initialDelaySeconds

   探测在容器启动后运行前的延迟（以秒为单位）。默认值为 5。

   注意

   如果部署也配置了启动探测，则可以将存活度和就绪度探测的延迟设置为 0。这两个探测仅在启动探测通过后运行。如果启动探测已经通过，它会确认代理已成功启动，因此不需要延迟运行存活度和就绪度探测。

   periodSeconds

   探测运行的时间间隔（以秒为单位）。默认值为 5。

   failureThreshold

   连续最小失败，包括表示探测失败的存活度探测的超时。当探测失败时，它会重启 Pod。默认值为 3。

   如果您的部署没有配置启动探测，它会验证代理应用程序是否在存活度探测运行前启动，您可能需要增加故障阈值，以允许代理有足够的时间启动并传递存活度探测检查。否则，代理可能会输入一个循环条件，其中不再达到失败阈值，代理 Pod 每次由存活度探测重启。

   代理启动和传递存活度探测检查所需的时间取决于集群的资源和代理日志的大小。例如，如果您将 failureThreshold 设置为 30，且探测在默认间隔 5 秒运行，代理需要 150 秒才能启动并传递存活度探测检查。

   注意

   如果您没有配置存活度探测，或者没有配置的探测，AMQ Broker Operator 会创建一个具有以下配置的默认 TCP 探测。默认 TCP 探测尝试为指定端口上的代理容器打开一个套接字。

   spec:
     deploymentPlan:
       livenessProbe:
         tcpSocket:
           port: 8181
         initialDelaySeconds: 30
         timeoutSeconds: 5

   Copy to Clipboard Toggle word wrap

3. 要配置就绪度探测，请在 CR 的 deploymentPlan 部分中添加一个 readinessProbe 部分。例如：

   spec:
     deploymentPlan:
       readinessProbe:
         initialDelaySeconds: 5
         periodSeconds: 5

   Copy to Clipboard Toggle word wrap

   如果您没有配置就绪度探测，则内置 脚本将检查 所有接收器是否可以接受连接。

4. 如果要配置更全面的健康检查，请将 artemis check 命令行工具添加到存活度或就绪度探测配置中。

   1. 如果要配置健康检查，以创建与代理的完整客户端连接，在 livenessProbe 或 readinessProbe 部分中，添加一个 exec 部分。在 exec 部分中，添加一个 command 部分。在 command 部分中，添加 artemis check node 命令语法。例如：

      spec:
        deploymentPlan:
          readinessProbe:
            exec:
              command:
                - bash
                - '-c'
                - /home/jboss/amq-broker/bin/artemis
                - check
                - node
                - '--silent'
                - '--acceptor'
                - <acceptor name>
                - '--user'
                - $AMQ_USER
                - '--password'
                - $AMQ_PASSWORD
            initialDelaySeconds: 30
            timeoutSeconds: 5

      Copy to Clipboard Toggle word wrap

      默认情况下，artemis check node 命令使用名为 artemis 的 acceptor 的 URI。如果代理有一个名为 artemis，您可以在命令中排除 --acceptor <acceptor name& gt; 选项。

      注意

      $AMQ_USER 和 $AMQ_PASSWORD 是 AMQ Operator 配置的环境变量。

   2. 如果要配置生成和消耗消息的健康检查，它也在 livenessProbe 或 readinessProbe 部分中验证代理文件系统的健康状态，请添加 exec 部分。在 exec 部分中，添加一个 command 部分。在 command 部分中，添加 artemis check queue 命令语法。例如：

      spec:
        deploymentPlan:
          readinessProbe:
            exec:
              command:
                - bash
                - '-c'
                - /home/jboss/amq-broker/bin/artemis
                - check
                - queue
                - '--name'
                - livenessqueue
                - '--produce'
                - "1"
                - '--consume'
                - "1"
                - '--silent'
                - '--user'
                - $AMQ_USER
                - '--password'
                - $AMQ_PASSWORD
            initialDelaySeconds: 30
            timeoutSeconds: 5

      Copy to Clipboard Toggle word wrap
      注意

      您指定的队列名称必须在代理上配置，且 anycast 为 routingType。例如：

      apiVersion: broker.amq.io/v1beta1
      kind: ActiveMQArtemisAddress
      metadata:
        name: livenessqueue
        namespace: activemq-artemis-operator
      spec:
        addressName: livenessqueue
        queueConfiguration:
          purgeOnNoConsumers: false
          maxConsumers: -1
          durable: true
          enabled: true
        queueName: livenessqueue
        routingType: anycast

      Copy to Clipboard Toggle word wrap
5. 保存 CR。