设置请求超时

了解如何设置 Knative 服务服务必须在多长时间内返回请求的响应。如果服务未在指定时间内返回响应,则请求将结束并返回错误 504

超时限制

超时上限因 GKE 集群的版本而异。

GKE 版本 默认限额 超时上限
0.16.0-gke.1 及更高版本 300 秒 24 小时
0.15.0-gke.3 及更早版本 300 秒 900 秒

除了更改 Knative 服务请求超时之外,您还应检查语言框架,以确定它是否有自己的请求超时设置,您必须对其进行更新。

设置和更新请求超时

任何配置更改都会导致新修订版本的创建。后续修订版本也将自动采用此配置设置,除非您进行了明确更新。

在部署新服务或更新现有服务并部署修订版本时,您可以使用 Google Cloud 控制台、Google Cloud CLI 或 YAML 文件设置请求超时:

控制台

  1. 前往 Google Cloud 控制台中的 Knative 服务:

    前往 Knative 服务

  2. 如果您是要配置一个新服务来作为部署目标,请点击创建服务。如果您要配置现有服务,请点击该服务,然后点击修改和部署新的修订版本

  3. 在“高级设置”下,点击容器

  4. 请求超时字段中,输入要使用的超时值。您指定的值必须小于集群的 GKE 版本的超时限制

  5. 点击下一步以转到下一部分。

  6. 配置此服务的触发方式部分,选择您想使用哪个连接来调用服务。

  7. 点击 Create 将映像部署到 Knative 服务,然后等待部署完成。

命令行

  • 对于现有服务,请运行带有 --timeout 参数的 gcloud run services update 命令来设置请求超时

    gcloud run services update SERVICE --timeout TIMEOUT
    

    您需要在其中:

    • SERVICE 替换为您的服务名称。
    • TIMEOUT 替换为所需时间;您可以使用整数值(以秒为单位),也可以使用绝对时长值,例如 1m20s(表示 1 分 20 秒)。您指定的值必须小于集群的 GKE 版本的超时限制。 指定 0 将超时设置为默认值
  • 对于新服务,请运行带有 --timeout 参数的 gcloud run deploy 命令来设置请求超时:

    gcloud run deploy SERVICE --image=IMAGE_URL --timeout TIMEOUT
    

    您需要将其中的:

    • SERVICE 替换为您的服务名称。
    • IMAGE_URL 替换为对容器映像的引用,例如 gcr.io/cloudrun/hello
    • TIMEOUT 替换为所需时间;您可以使用整数值(以秒为单位),也可以使用绝对时长值,例如 1m20s(表示 1 分 20 秒)。您指定的值必须小于集群的 GKE 版本的超时限制。 指定 0 将超时设置为默认值

YAML

您可以使用 gcloud run services describe 命令和 --format=export 标志将现有服务的配置下载到的 YAML 文件中。然后,您可以使用 gcloud run services replace 命令修改该 YAML 文件并部署这些更改。您必须确保仅修改指定的属性。

  1. 将服务配置下载到本地工作区上名为 service.yaml 的文件中:

    gcloud run services describe SERVICE --format export > service.yaml

    SERVICE 替换为 Knative 服务服务的名称。

  2. 在本地文件中,更新 timeoutSeconds 属性:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        spec:
          containers:
          - image: IMAGE
          timeoutSeconds: TIMEOUT

    您需要在其中:

    • SERVICE 替换为您的 Knative 服务服务的名称
    • IMAGE_URL 替换为对容器映像的引用,例如 gcr.io/cloudrun/hello
    • TIMEOUT 替换为所需的超时(以秒为单位)。
  3. 使用以下命令将服务替换为其新配置:

    gcloud run services replace service.yaml