4.10. 配置修订超时

流程

1. 运行以下命令，将订阅中的 ROUTE_HAPROXY_TIMEOUT 的值设置为所需的超时时间（以秒为单位）。请注意，这会导致重新部署 openshift-serverless 命名空间中的 pod。

   将 ROUTE_HAPROXY_TIMEOUT 值设置为 900 秒

   $ oc patch subscription.operators.coreos.com serverless-operator -n openshift-serverless --type='merge' -p '{"spec": {"config": {"env": [{"name": "ROUTE_HAPROXY_TIMEOUT", "value": "900"}]}}}'

   Copy to Clipboard

   或者，您可以直接在订阅中设置 ROUTE_HAPROXY_TIMEOUT 的值：

   将 ROUTE_HAPROXY_TIMEOUT 设置为 900 秒的订阅定义

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
   #...
   spec:
     channel: stable
     config:
       env:
         - name: ROUTE_HAPROXY_TIMEOUT
           value: '900'
   #...

   Copy to Clipboard

   注意

   如果您使用 service.knative.openshift.io/disableRoute 注解手动创建路由并禁用自动生成，您可以在路由定义中直接配置超时。

2. 在 KnativeServing CR 中设置最大修订超时：

   将 max-revision-timeout-seconds 设置为 900 秒的 KnativeServing CR

   apiVersion: operator.knative.dev/v1beta1
   kind: KnativeServing
   metadata:
     name: knative-serving
   spec:
     config:
       defaults:
         max-revision-timeout-seconds: "900"
   #...

   Copy to Clipboard

   Serverless Operator 会自动将激活器的 terminationGracePeriod 值调整为设定的最大修订超时值，以避免在激活器 pod 被终止时请求终止。

3. 可选：运行以下命令来验证超时是否已设置：

   $ oc get deployment activator -n knative-serving -o jsonpath="{.spec.template.spec.terminationGracePeriodSeconds}"

   Copy to Clipboard

4. 如果云供应商需要，请运行以下命令来调整负载均衡器超时：

   AWS Classic LB 的负载均衡器超时调整

   $ oc -n openshift-ingress-operator patch ingresscontroller/default --type=merge --patch=' \
     {"spec":{"endpointPublishingStrategy":  \
     {"type":"LoadBalancerService", "loadBalancer":  \
     {"scope":"External", "providerParameters":{"type":"AWS", "aws":  \
     {"type":"Classic", "classicLoadBalancer":  \
     {"connectionIdleTimeout":"20m"}}}}}}}'

   Copy to Clipboard

5. 使用所需的超时部署 Knative 服务，或等于 max-revision-timeout-seconds 变量：

   将超时设置为 800 秒的服务定义

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: example-service-name
   spec:
     template:
       spec:
         timeoutSeconds: 800
         responseStartTimeoutSeconds: 800

   Copy to Clipboard

   重要

   使用 Service Mesh 时，如果在长时间运行的请求处于动态状态时停止 activator pod，则请求会中断。为了避免请求中断，您必须调整 ServiceMeshControlPlane CR 中的 terminationDrainDuration 字段的值：

   apiVersion: maistra.io/v2
   kind: ServiceMeshControlPlane
   #...
   spec:
     techPreview:
         meshConfig:
           defaultConfig:
             terminationDrainDuration: 1000s 

   1

   
   #...

   Copy to Clipboard

   1

   确保该值超过请求持续时间，以避免 Istio 代理关闭，这会中断请求。

流程

1. 根据需要，在 KnativeServing CR 中设置 max-revision-timeout 注解：

   apiVersion: operator.knative.dev/v1beta1
   kind: KnativeServing
   metadata:
     name: knative-serving
   spec:
     config:
       defaults:
         max-revision-timeout-seconds: "900"

   Copy to Clipboard

2. 可选：运行以下命令来验证激活器的终止宽限期：

   $ oc get deployment activator -n knative-serving -o jsonpath="{.spec.template.spec.terminationGracePeriodSeconds}"
   
   900

   Copy to Clipboard

3. 如果云供应商需要，请运行以下命令来调整负载均衡器超时：

   AWS Classic LB 的负载均衡器超时调整

   $ oc -n openshift-ingress-operator patch ingresscontroller/default \
     --type=merge --patch='{"spec":{"endpointPublishingStrategy":  \
     {"type":"LoadBalancerService", "loadBalancer":  \
     {"scope":"External", "providerParameters":{"type":"AWS", "aws":  \
     {"type":"Classic", "classicLoadBalancer":  \
     {"connectionIdleTimeout":"20m"}}}}}}}'

   Copy to Clipboard

4. 为特定服务设置超时：

   apiVersion: serving.knative.dev/v1f
   kind: Service
   metadata:
     name: <your_service_name>
     annotations:
       serving.knative.openshift.io/setRouteTimeout: "800" 

   1

   
   spec:
     template:
       metadata:
         annotations:
   #...
       spec:
         timeoutSeconds: 800 

   2

   
         responseStartTimeoutSeconds: 800 

   3

   Copy to Clipboard

   1

   此注解为 OpenShift Container Platform 路由设置超时。您可以为每个服务微调，而不是设置全局最大值。

   2

   这样可确保请求不会超过特定值。

   3

   这样可确保在达到最大阈值前不会触发响应启动超时。默认值为 300。

   重要

   使用 Service Mesh 时，如果在长时间运行的请求处于动态状态时停止 activator pod，则请求会中断。为了避免请求中断，您必须调整 ServiceMeshControlPlane CR 中的 terminationDrainDuration 字段的值：

   apiVersion: maistra.io/v2
   kind: ServiceMeshControlPlane
   #...
   spec:
     techPreview:
         meshConfig:
           defaultConfig:
             terminationDrainDuration: 1000s 

   1

   
   #...

   Copy to Clipboard

   1

   确保该值超过请求持续时间，以避免 Istio 代理关闭，这会中断请求。