최신 SDK(PHP)로 업그레이드하여 push 큐를 Cloud Tasks로 마이그레이션

최신 App Engine 서비스 SDK 버전으로 업그레이드하기 전에 마이그레이션 개요를 검토하세요.

App Engine 서비스 SDK를 최신 버전으로 업데이트하여 Cloud Tasks로 자동 마이그레이션할 수 있습니다. 업그레이드 후 SDK는 PushQueue 호출을 Cloud Tasks 프런트엔드 API로 자동으로 리디렉션합니다. Cloud Tasks는 기존 태스크 큐와 태스크를 유지하므로 추가 마이그레이션이 필요하지 않습니다.

내부적으로 업데이트된 SDK는 Cloud Tasks API를 사용하여 태스크 큐 기능과 기능 동등성을 유지하며 SDK는 다음을 지원합니다.

  • 일괄 작업 생성: SDK는 일괄 API를 사용하여 단일 호출에서 최대 100개의 작업을 추가할 수 있습니다.
  • 태스크 수준 재시도: SDK는 태스크별 재시도 구성을 지원합니다.

가격 책정 및 할당량

push 큐를 Cloud Tasks로 마이그레이션하면 앱의 가격 책정 및 할당량에 영향을 줄 수 있습니다.

가격 책정

마이그레이션하기 전에 Cloud Tasks 가격 책정을 검토하여 월별 비용을 추정합니다.

태스크 큐와 마찬가지로 Cloud Tasks push 대상을 사용하여 App Engine 앱에 요청을 전송하는 것은 무료입니다. 하지만 태스크 큐와 달리 Cloud Tasks는 태스크 생성, 삭제, 관리와 같은 작업에 대해 요금을 청구합니다. 이로 인해 무료 App Engine 태스크 큐에 비해 전체 월별 비용이 더 높아질 수 있습니다.

할당량

Cloud Tasks 요청은 App Engine 요청 할당량에도 반영됩니다.

태스크 큐와 마찬가지로 Cloud Tasks에는 서비스별 할당량이 있습니다. Cloud Tasks로 마이그레이션하면 할당량이 변경될 수 있습니다.

요청 지연 시간 최적화

업데이트된 SDK는 요청을 Cloud Tasks API로 직접 전송하므로 개별 태스크를 순차적으로 큐에 추가하거나 삭제하면 기존 태스크 큐 서비스에 비해 요청 지연 시간이 늘어날 수 있습니다. 지연 시간을 최소화하려면 다음 안내를 따르세요.

  • 여러 태스크를 단일 호출로 일괄 처리: 루프에서 태스크를 하나씩 큐에 추가하는 대신 태스크를 일괄 추가 호출로 그룹화합니다(호출당 최대 100개 태스크).

시작하기 전에

push 큐를 Cloud Tasks로 마이그레이션하기 전에 다음 단계를 완료하세요.

  1. App Engine 소스 코드에 액세스할 수 있는지 확인합니다.

  2. Cloud Tasks 및 Cloud Scheduler API를 사용 설정합니다.

    API 사용 설정

  3. App Engine 서비스 계정에 SDK가 Cloud Tasks API에 태스크를 디스패치하는 데 필요한 권한이 있는지 확인하려면 관리자에게 프로젝트에 대한 Cloud Tasks 큐 추가자(roles/cloudtasks.enqueuer) IAM 역할을 부여해 달라고 요청하세요.

App Engine 서비스 SDK 업데이트

  1. 애플리케이션에서 최신 버전의 App Engine 서비스 SDK를 사용하는지 확인합니다.

    composer.json 파일에서 google/appengine-php-sdk를 버전 ^2.3 이상으로 업데이트하고 google/cloud-tasks를 추가합니다.

    {
      "require": {
        "google/appengine-php-sdk": "^2.3",
        "google/cloud-tasks": "^2.3"
      }
    }
  2. Cloud Tasks 라우팅 사용 설정

    runtime: php85
    service: my-service-b
    
    env_variables:
      APPENGINE_USE_CLOUDTASK_PUSH_QUEUE: "true"
    
  3. 앱을 배포합니다.

    gcloud app deploy
    
  4. 앱이 Cloud Tasks를 사용 중인지 확인하려면Google Cloud 콘솔의 Cloud Tasks 페이지로 이동합니다.

다음 단계