设置请求超时

请求超时设置用于指定部署到 Cloud Run 的服务必须返回响应的时间范围。如果服务未在指定时间内返回响应,则请求将结束并返回错误 504。

超时默认设置为 5 分钟,最长可延长至 60 分钟。

您可以在部署容器映像或更新服务配置时更改此设置。

除了更改 Cloud Run 请求超时之外,您还应检查语言框架,以确定其中是否包含专用的请求超时设置,该设置也必须进行更新。

设置和更新请求超时

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

您可以在创建新服务部署新修订版本时使用 Cloud Console、gcloud 命令行或 YAML 文件设置请求超时。

控制台

  1. 转到 Cloud Run

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

  3. 如果您要配置新服务,请根据需要填写初始服务设置页面,然后点击下一步 > 高级设置,以访问服务配置页面。

  4. 点击容器标签页。

    图片

  5. 请求超时字段中,输入要使用的超时值(以秒为单位)。请使用 13600 秒,或 1 到 60 分钟之间的值。

  6. 点击创建部署

命令行

您可以随时使用以下命令更新给定修订版本的请求超时

gcloud run services update [SERVICE] --timeout=[TIMEOUT]

替换

  • [SERVICE] 替换为您的服务名称。
  • [TIMEOUT] 替换为所需时间;您可以使用整数值,也可以使用绝对时长值,例如 1m20s(表示 1 分 20 秒)。如果使用整数值,则假定单位为秒。您指定的值必须少于 60 分钟。

您还可以在部署期间使用以下命令设置请求超时:

gcloud run deploy --image IMAGE_URL --timeout=[TIMEOUT]

替换

  • IMAGE_URL 替换为对容器映像的引用(例如 us-docker.pkg.dev/cloudrun/container/hello:latest)。
  • [TIMEOUT] 替换为所需时间;您可以使用整数值,也可以使用时长值,例如 1m20s(表示 1 分 20 秒)。如果使用整数值,则假定单位为秒。您指定的值必须少于 60 分钟。

YAML

您可以使用 gcloud run services describe --format export 命令下载并查看现有服务配置,该命令会生成清理后的 YAML 格式的结果。然后,您可以使用 gcloud run services replace 命令修改下述字段并上传修改后的 YAML。请务必仅修改记录的字段。

  1. 要查看和下载配置,请运行以下命令:

    gcloud run services describe SERVICE --format export > service.yaml
  2. 更新 timeoutSeconds 特性:

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

    替换

    • SERVICE 替换为您的 Cloud Run 服务的名称
    • IMAGE 替换为容器映像的网址。
    • VALUE 替换为所需的超时(以秒为单位)。
  3. 使用以下命令将服务替换为其新配置:

    gcloud run services replace service.yaml

查看请求超时设置

如需查看服务的当前请求超时设置,请执行以下操作:

控制台

  1. 转到 Cloud Run

  2. 点击您感兴趣的服务以打开“服务详细信息”页面。

  3. 点击修订版本标签页。

  4. 在右侧的详细信息面板中,“容器”标签页下列出了请求超时设置。

命令行

  1. 使用以下命令:

    gcloud run services describe SERVICE
  2. 在返回的配置中找到请求超时设置。