Como definir o tempo limite da solicitação (serviços)

Para os serviços do Cloud Run, a configuração de tempo limite da solicitação especifica o tempo em que uma resposta precisa ser retornada pelos serviços implantados no Cloud Run. Se uma resposta não for retornada dentro do tempo especificado, a solicitação será finalizada e o erro 504 será retornado.

O tempo limite é definido por padrão como cinco minutos e pode ser estendido para até 60 minutos.

É possível alterar essa configuração ao implantar uma imagem de contêiner ou atualizando a configuração do serviço.

Além de alterar o tempo limite da solicitação do Cloud Run, verifique o framework da linguagem para ver se ele tem a própria configuração de tempo limite de solicitação que você também precisa atualizar.

Como configurar e atualizar o tempo limite da solicitação

Qualquer mudança na configuração leva à criação de uma nova revisão. As próximas revisões também recebem automaticamente essa configuração, a menos que você faça atualizações explícitas para alterá-la.

É possível definir o tempo limite da solicitação usando o console do Google Cloud, a linha de comando gcloud ou um arquivo YAML ao criar um novo serviço ou implantar uma nova revisão.

Console

Acessar o Cloud Run
Clique em Criar serviço se estiver configurando um novo serviço em que fará uma implantação. Se você estiver configurando um serviço atual, clique nele e em Editar e implantar nova revisão.
Se você estiver configurando um novo serviço, preencha a página inicial de configurações de serviço conforme desejado e clique em Contêiner, redes, segurança para expandir a página de configuração do serviço.
Clique na guia Contêiner.
No campo Tempo limite da solicitação, insira o valor de tempo limite que você quer usar em segundos. Use valores que vão de 1 a 3600 segundos ou de 1 a 60 minutos.
Clique em Criar ou Salvar.

Linha de comando

É possível atualizar o tempo limite da solicitação para uma determinada revisão a qualquer momento, usando o comando a seguir:

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

Substitua:

[SERVICE] pelo nome do serviço.
[TIMEOUT] pelo tempo que você quer, usando um valor inteiro ou um valor de duração absoluta. Por exemplo, 1m20s, que é 1 minuto e 20 segundos. Se você usar um valor inteiro, a unidade será considerada como segundos. O valor especificado precisa ser menor que 15 minutos.

Observação: quando você atualiza o serviço com o novo valor de tempo limite, uma nova revisão é criada.

Também é possível definir o tempo limite da solicitação durante a implantação usando o comando a seguir:

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

Substitua:

IMAGE_URL por uma referência à imagem de contêiner. Por exemplo, us-docker.pkg.dev/cloudrun/container/hello:latest;
[TIMEOUT] pelo tempo que você quer, usando um valor inteiro ou um valor de duração. Por exemplo, 1m20s, que é de 1 minuto e 20 segundos. Se você usar um valor inteiro, a unidade será considerada como segundos. O valor especificado precisa ser menor que 15 minutos.

YAML

É possível fazer o download e conferir as configurações de serviço usando o comando gcloud run services describe --format export, que produz resultados limpos no formato YAML. Em seguida, modifique os campos descritos abaixo e faça upload do YAML modificado usando o comando gcloud run services replace. Modifique os campos somente conforme documentado.

Para visualizar e fazer o download da configuração:

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

Atualize o atributo timeoutSeconds:
```
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
spec:
  template:
    metadata:
      name: REVISION
    spec:
      containers:
      - image: IMAGE
      timeoutSeconds: VALUE
```
Substitua:
- SERVICE pelo nome do serviço do Cloud Run;
- IMAGE_URL por uma referência à imagem de contêiner. Por exemplo, us-docker.pkg.dev/cloudrun/container/hello:latest;
- VALUE pelo tempo limite que você quer, em segundos.
- REVISION por um novo nome de revisão ou excluí-lo (se houver). Se você fornecer um novo nome de revisão, ele precisará atender aos seguintes critérios:
  - Começa com SERVICE-
  - Contém apenas letras minúsculas, números e -
  - Não termina com um -
  - Não excede 63 caracteres
Substitua o serviço pela nova configuração usando o seguinte comando:
```
gcloud run services replace service.yaml
```

Terraform

Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform.

Adicione o seguinte a um recurso google_cloud_run_service em template.spec na configuração do Terraform. Substitua 300 pelo tempo limite da solicitação desejado para o serviço (em segundos).

run/container_template/main.tf (em inglês)

Acessar no GitHub Feedback

# Timeout
# https://cloud.google.com/run/docs/configuring/request-timeout
timeout_seconds = 300

Ver configurações de tempo limite da solicitação

Para ver as configurações atuais de tempo limite da solicitação do serviço do Cloud Run, faça o seguinte:

Console

Acesse o Cloud Run
Clique no serviço de seu interesse para abrir a página Detalhes do serviço.
Clique na guia Revisões.
No painel de detalhes à direita, a configuração de tempo limite da solicitação está listada na guia Contêiner.

Linha de comando

Use o comando a seguir:
```
gcloud run services describe SERVICE
```
Localize a configuração de tempo limite da solicitação na configuração retornada.