요청 제한 시간 설정(서비스)

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

제한 시간은 기본적으로 5분으로 설정되며, 최대 60분까지 연장될 수 있습니다.

중요: 제한 시간이 15분을 초과할 경우에는 재시도를 구현하고, 요청이 멱등적인지 확인하거나 종료된 지점에서 재개될 수 있도록 요청 핸들러를 설계하여 연결이 손실될 경우를 대비해서 클라이언트가 다시 연결되어도 서비스에 영향을 주지 않도록 하는 것이 좋습니다. 제한 시간이 길어질수록 클라이언트 측 또는 Cloud Run 측의 오류로 인해 연결이 손실될 가능성도 커집니다. 클라이언트가 다시 연결되면 새 요청이 시작되고 클라이언트가 서비스의 동일 인스턴스에 연결된다고 보장할 수 없습니다.

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

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

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

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

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

콘솔

1. Cloud Run으로 이동

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

3. 새 서비스를 구성하는 경우 원하는 대로 초기 서비스 설정 페이지를 작성한 후 컨테이너, 네트워킹, 보안을 클릭하여 서비스 구성 페이지를 펼칩니다.

4. 컨테이너 탭을 클릭합니다.

   

5. In the 요청 제한 시간 필드에서 사용할 제한 시간 값을 초 단위로 입력합니다. 1~3600초 또는 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

YAML 형식으로 정리된 결과를 생성하는 gcloud run services describe --format export 명령어를 사용하면 기존 서비스 구성을 다운로드해서 볼 수 있습니다. 그런 다음 아래 설명된 필드를 수정하고 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:
       metadata:
         name: REVISION
       spec:
         containers:
         - image: IMAGE
         timeoutSeconds: VALUE

   다음과 같이 바꿉니다.

   • SERVICE: Cloud Run 서비스 이름
   • IMAGE_URL을 컨테이너 이미지에 대한 참조(예: us-docker.pkg.dev/cloudrun/container/hello:latest)로 바꿉니다.
   • VALUE를 원하는 제한 시간(초 단위)으로 바꿉니다.
   • REVISION을 새 버전 이름으로 변경하거나 이미 있는 경우 삭제합니다. 새 버전 이름을 제공할 경우 다음 기준을 반드시 충족해야 합니다.
     • SERVICE-로 시작해야 합니다.
     • 소문자, 숫자, -만 포함합니다.
     • -로 끝나면 안 됩니다.
     • 63자(영문 기준) 이하여야 합니다.

3. 다음 명령어를 사용하여 서비스를 새 구성으로 바꿉니다.

   gcloud run services replace service.yaml

Terraform

Terraform 구성을 적용하거나 삭제하는 방법은 기본 Terraform 명령어를 참조하세요.

template.spec 아래의 Terraform 구성에서 google_cloud_run_service 리소스에 다음 항목을 추가합니다. 300을 서비스에 사용할 요청 제한 시간(초)으로 바꿉니다.

run/container_template/main.tf

GitHub에서 보기 의견 보내기

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

요청 제한 시간 설정 보기

Cloud Run 서비스의 현재 요청 제한 시간 설정을 보려면 다음 안내를 따르세요.

콘솔

1. Cloud Run으로 이동

2. 관심이 있는 서비스를 클릭하여 서비스 세부정보 페이지를 엽니다.

3. 버전 탭을 클릭합니다.

4. 오른쪽의 세부정보 패널에서 요청 제한 시간 설정이 컨테이너 탭에 표시됩니다.

명령줄

1. 다음 명령어를 사용하세요.

   gcloud run services describe SERVICE

2. 반환된 구성에서 요청 제한 시간 설정을 찾습니다.