4.10. リビジョンタイムアウトの設定

手順

1. 次のコマンドを実行して、サブスクリプションの ROUTE_HAPROXY_TIMEOUT の値を必要なタイムアウト (秒単位) に設定します。これにより、openshift-serverless namespace 内の 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 Toggle word wrap

   または、サブスクリプションで 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 Toggle word wrap

   注記

   ルートを手動で作成し、serving.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 Toggle word wrap

   Serverless Operator は、アクティベーター Pod 自体が終了される場合にリクエストが終了しないように、アクティベーターの terminationGracePeriod 値を設定された最大リビジョンタイムアウト値に自動的に調整します。

3. オプション: 次のコマンドを実行して、タイムアウトが設定されていることを確認します。

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

   Copy to Clipboard Toggle word wrap

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 Toggle word wrap

5. 必要なタイムアウトが max-revision-timeout-seconds 変数以下の Knative サービスをデプロイします。

   タイムアウトを 800 秒に設定したサービス定義

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

   Copy to Clipboard Toggle word wrap

   重要

   Service Mesh を使用する場合、長時間実行リクエストが処理中にアクティベーター Pod が停止すると、リクエストは中断されます。リクエストの中断を回避するには、ServiceMeshControlPlane CR の terminationDrainDuration フィールドの値を調整する必要があります。

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

   1

   
   #...

   Copy to Clipboard Toggle word wrap

   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 Toggle word wrap

2. オプション: 次のコマンドを実行して、アクティベーターの終了猶予期間を確認します。

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

   Copy to Clipboard Toggle word wrap

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 Toggle word wrap

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 Toggle word wrap

   1

   このアノテーションは、OpenShift Container Platform ルートのタイムアウトを設定します。グローバル最大値を設定する代わりに、各サービスごとにこれを微調整できます。

   2

   これにより、リクエストが特定の値を超えないようにします。

   3

   これにより、最大しきい値に達する前に応答開始タイムアウトがトリガーされないようになります。デフォルト値は 300 です。

   重要

   Service Mesh を使用する場合、長時間実行リクエストが処理中にアクティベーター Pod が停止すると、リクエストは中断されます。リクエストの中断を回避するには、ServiceMeshControlPlane CR の terminationDrainDuration フィールドの値を調整する必要があります。

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

   1

   
   #...

   Copy to Clipboard Toggle word wrap

   1

   リクエストを中断する Istio プロキシーのシャットダウンを回避するために、値がリクエスト期間を超えていることを確認してください。