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

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

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

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

  • 일괄 작업 생성: SDK는 일괄 API를 사용하여 단일 호출에서 최대 100개의 작업을 추가할 수 있습니다.
  • 일괄 작업 삭제: SDK는 일괄 API를 사용하여 단일 호출에서 최대 1,000개의 작업을 삭제할 수 있습니다.
  • 태스크 수준 재시도: SDK는 태스크별 재시도 구성을 지원합니다.
  • 트랜잭션 태스크: SDK는 Datastore 트랜잭션 내에서 태스크를 큐에 추가합니다. 안정성을 유지하려면 cron.yaml 파일을 만들거나 수정합니다.

가격 책정 및 할당량

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

가격 책정

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

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

App Engine 서비스 SDK를 업그레이드하여 마이그레이션하고 애플리케이션이 Datastore 트랜잭션 내에서 트랜잭션 태스크를 큐에 추가하는 경우 큐에 추가된 각 태스크는 표준 Cloud Tasks API 청구 외에도 Datastore에서 쓰기 3회, 읽기 2회, 삭제 1회를 발생시킵니다.

할당량

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

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

요청 지연 시간 최적화

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

  • 여러 작업을 단일 호출로 일괄 처리: 루프에서 작업을 하나씩 큐에 추가하거나 삭제하는 대신 작업을 일괄 추가 호출(호출당 최대 100개 작업) 또는 일괄 삭제 호출(호출당 최대 1,000개 작업)로 그룹화합니다.
  • 비동기 API 호출 사용: 태스크 작업이 요청 처리를 차단하지 않도록 addAsync() 및 deleteTaskAsync()와 같은 비차단 메서드를 사용합니다.

시작하기 전에

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를 사용하는지 확인합니다.

    pom.xml에서 App Engine 서비스 SDK를 버전 5.2.0 이상으로 업데이트합니다.

    <dependency>
        <groupId>com.google.appengine</groupId>
        <artifactId>appengine-api-1.0-sdk</artifactId>
        <version>5.2.0</version>
    </dependency>
  2. Cloud Tasks 라우팅 사용 설정

    runtime: java25
    service: my-service-b
    
    env_variables:
      APPENGINE_USE_CLOUDTASK_PUSH_QUEUE: "true"
    

    pom.xml의 App Engine SDK 종속 항목을 버전 5.2.0 이상으로 업데이트합니다.

    앱에서 XML 구성(appengine-web.xml)을 사용하는 경우:

    <appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
      <service>my-java-service-b</service>
      <runtime>java25</runtime>
      <env-variables>
        <env-var name="APPENGINE_USE_CLOUDTASK_PUSH_QUEUE" value="true" />
      </env-variables>
    </appengine-web-app>
    
  3. 앱을 배포합니다.

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

트랜잭션 작업 구성(선택사항)

앱이 Datastore 트랜잭션 내에서 태스크를 큐에 추가하는 경우 SDK는 내부 크론 작업을 사용하여 Datastore 커밋 중에 큐에 추가되지 않은 태스크가 결국 처리되도록 합니다.

push 큐 트랜잭션 태스크를 처리하려면 cron.yaml 파일을 만들거나 업데이트하여 내부 프로세서를 주기적으로 호출합니다. 예를 들면 다음과 같습니다.

cron:
- description: "Process push queue transactional tasks"
  url: /_ah/cloudtask/sweep
  schedule: every 30 minutes # Change this based on the usage pattern

web.xml 파일에 com.google.apphosting.utils.servlet.SweeperServlet의 URL 맵을 추가하거나 Java 17 이상 자카르타 EE 런타임의 경우 com.google.apphosting.utils.servlet.jakarta.SweeperServlet을 추가합니다.

<servlet>
 <servlet-name>cloudtask_sweep</servlet-name>
 <servlet-class>com.google.apphosting.utils.servlet.SweeperServlet</servlet-class>
</servlet>
<servlet-mapping>
 <servlet-name>cloudtask_sweep</servlet-name>
 <url-pattern>/_ah/cloudtask/sweep</url-pattern>
</servlet-mapping>

다음 단계