요청 시간 제한 설정

요청 시간 제한 설정은 Cloud Run에 배포된 서비스에서 응답을 반환해야 하는 시간을 지정합니다. 지정된 시간 내에 응답이 반환되지 않으면 요청이 종료되고 오류 504가 반환됩니다.

기본적으로 제한 시간은 5분으로 설정됩니다.

컨테이너 이미지를 배포할 때 또는 서비스 구성을 업데이트하여 이 설정을 변경할 수 있습니다.

Cloud Run 요청 시간 제한을 변경하는 것 외에도 언어 프레임워크를 확인하여 업데이트가 필요한 자체 요청 시간 제한 설정이 있는지 확인해야 합니다.

요청 시간 제한 설정 및 업데이트

구성을 변경하면 새 버전이 생성됩니다. 이를 변경하는 명시적 업데이트가 없으면 이후 버전에도 이 구성 설정이 자동으로 적용됩니다.

새 서비스를 만들거나 새 버전을 배포할 때 Cloud Console, gcloud 명령줄 또는 YAML 파일을 사용하여 요청 시간 제한을 설정할 수 있습니다.

콘솔

15분을 초과하는 시간 제한은 베타 기능입니다.

  1. Cloud Run으로 이동

  2. 배포할 새 서비스를 구성하려면 서비스 만들기를 클릭합니다. 기존 서비스를 구성하는 경우 서비스를 클릭한 다음 새 버전 수정 및 배포를 클릭합니다.

  3. 고급 설정에서 컨테이너를 클릭합니다.

    이미지

  4. 요청 시간 제한 필드에 사용할 시간 제한 값을 초 단위로 입력합니다. 다음 범위를 사용할 수 있습니다.

    • Cloud Run(완전 관리형)의 경우 1~900초(15분) 사이의 값을 사용합니다. 값은 최대 60분으로 지정할 수 있지만 15분을 초과하는 제한 시간은 베타 기능입니다.
    • Google Cloud의 Cloud Run for Anthos의 경우 1~600초(10분) 사이의 값을 사용합니다.

  5. 만들기 또는 배포를 클릭합니다.

명령줄

다음 명령어를 사용하여 언제든지 지정된 버전의 요청 시간 제한을 업데이트할 수 있습니다.

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

다음과 같이 바꿉니다.

  • [SERVICE]를 서비스 이름으로 바꿉니다.
  • [TIMEOUT]을 정수 값 또는 절대 지속 시간 값을 사용하여 원하는 시간으로 바꿉니다. 예를 들어 1m20s는 1분 20초입니다. 정수 값을 사용하면 단위는 초로 간주됩니다. Cloud Run(완전 관리형)의 경우 60분 미만 또는 Google Cloud의 Cloud Run for Anthos에서는 10분 미만으로 값을 지정해야 합니다. 15분을 초과하는 시간 제한은 베타 기능이며 gcloud beta run 명령어를 사용해야 합니다.

배포 중에 다음 명령어를 사용하여 요청 시간 제한을 설정할 수도 있습니다.

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

다음과 같이 바꿉니다.

  • IMAGE_URL을 컨테이너 이미지에 대한 참조(예를 들어 gcr.io/myproject/my-image:latest)로 바꿉니다.
  • [TIMEOUT]을 정수 값 또는 지속 시간 값을 사용하여 원하는 시간으로 바꿉니다. 예를 들어 1m20s는 1분 20초입니다. 정수 값을 사용하면 단위는 초로 간주됩니다. 이 값은 완전 관리형 Cloud Run의 경우 60분 미만, Cloud Run for Anthos on Google Cloud의 경우 10분 미만으로 지정해야 합니다. 15분을 초과하는 시간 제한은 베타 기능이며 gcloud beta run 명령어를 사용해야 합니다.

YAML

YAML 형식으로 정리된 결과를 반환하는 gcloud run services describe --format export 명령어를 사용하면 기존 서비스 구성을 다운로드하고 볼 수 있습니다. 그런 다음 아래 설명된 필드를 수정하고 gcloud beta 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를 컨테이너 이미지의 URL로 바꿉니다.
    • VALUE를 원하는 시간 제한(초 단위)으로 바꿉니다.
  3. 다음 명령어를 사용하여 서비스를 새 구성으로 바꿉니다.

    gcloud beta run services replace service.yaml