Sebelum mengupgrade ke versi SDK layanan App Engine terbaru, tinjau ringkasan migrasi.
Anda dapat bermigrasi ke Cloud Tasks secara otomatis dengan mengupdate SDK layanan App Engine ke versi terbaru. Setelah Anda mengupgrade, SDK akan otomatis mengalihkan panggilan PushQueue ke API frontend Cloud Tasks untuk Anda. Cloud Tasks mempertahankan task queue dan tugas yang ada, sehingga tidak diperlukan migrasi tambahan.
Di balik layar, SDK yang diupdate menggunakan Cloud Tasks API untuk mempertahankan paritas fitur dengan fitur Task Queue, SDK mendukung hal berikut:
- Pembuatan tugas batch: SDK menggunakan API batch untuk mendukung penambahan hingga 100 tugas dalam satu panggilan.
- Penghapusan tugas batch: SDK menggunakan API batch untuk mendukung penghapusan hingga 1.000 tugas dalam satu panggilan.
- Percobaan ulang tingkat tugas: SDK mendukung konfigurasi percobaan ulang khusus tugas.
- Tugas transaksional: SDK mengantrekan tugas dalam transaksi Datastore. Untuk menjaga keandalan, buat atau ubah file
cron.yaml.
Harga dan kuota
Memigrasikan push queue ke Cloud Tasks dapat memengaruhi harga dan kuota untuk aplikasi Anda.
Harga
Tinjau harga Cloud Tasks untuk memperkirakan biaya bulanan Anda sebelum bermigrasi.
Mirip dengan Task Queue, mengirim permintaan ke aplikasi App Engine Anda dengan target push Cloud Tasks tidak dikenai biaya. Namun, tidak seperti Task Queue, Cloud Tasks mengenakan biaya untuk operasi yang dilakukan, seperti membuat, menghapus, atau mengelola tugas. Hal ini dapat menyebabkan biaya bulanan keseluruhan yang lebih tinggi dibandingkan dengan Task Queue App Engine gratis.
Jika Anda bermigrasi dengan mengupgrade SDK layanan App Engine dan aplikasi Anda mengantrekan tugas transaksional dalam transaksi Datastore, setiap tugas yang diantrekan akan dikenai biaya 3 penulisan, 2 pembacaan, dan 1 penghapusan di Datastore selain penagihan Cloud Tasks API standar.
Kuota
Permintaan Cloud Tasks juga mengurangi kuota permintaan App Engine Anda.
Seperti Task Queue, Cloud Tasks memiliki kuota khusus layanan. Migrasi ke Cloud Tasks kemungkinan akan mengubah kuota Anda.
Mengoptimalkan latensi permintaan
Karena SDK yang diupdate mengirim permintaan langsung ke Cloud Tasks API, mengantrekan atau menghapus tugas satu per satu secara berurutan dapat meningkatkan latensi permintaan dibandingkan dengan layanan Task Queue lama. Untuk meminimalkan latensi:
- Menggabungkan beberapa tugas ke dalam satu panggilan: Kelompokkan tugas ke dalam panggilan penambahan batch (hingga 100 tugas per panggilan) atau panggilan penghapusan batch (hingga 1.000 tugas per panggilan), bukan mengantrekan atau menghapus tugas satu per satu dalam loop.
- Gunakan panggilan API asinkron: Gunakan metode non-pemblokiran seperti
addAsync()dandeleteTaskAsync()agar operasi tugas tidak memblokir penanganan permintaan.
Sebelum memulai
Selesaikan langkah-langkah berikut sebelum memigrasikan push queue ke Cloud Tasks:
Pastikan Anda memiliki akses ke kode sumber App Engine.
Aktifkan Cloud Tasks dan Cloud Scheduler API:
Untuk memastikan bahwa akun layanan App Engine memiliki izin yang diperlukan agar SDK dapat mengirim tugas ke Cloud Tasks API, minta administrator untuk memberikan peran IAM Cloud Tasks Enqueuer (
roles/cloudtasks.enqueuer) pada project.
Mengupdate SDK layanan App Engine
Pastikan aplikasi Anda menggunakan SDK layanan App Engine versi terbaru.
Di
pom.xml, update SDK layanan App Engine ke versi5.2.0atau yang lebih tinggi.<dependency> <groupId>com.google.appengine</groupId> <artifactId>appengine-api-1.0-sdk</artifactId> <version>5.2.0</version> </dependency>
Mengaktifkan pemilihan rute Cloud Tasks
runtime: java25 service: my-service-b env_variables: APPENGINE_USE_CLOUDTASK_PUSH_QUEUE: "true"Update dependensi App Engine SDK di
pom.xmlAnda ke versi5.2.0atau yang lebih tinggi.Jika aplikasi Anda menggunakan konfigurasi 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>Men-deploy aplikasi Anda:
gcloud app deployUntuk memverifikasi bahwa aplikasi Anda menggunakan Cloud Tasks, buka halaman Cloud Tasks di konsolGoogle Cloud .
Mengonfigurasi tugas transaksional (opsional)
Jika aplikasi Anda mengantrekan tugas dalam transaksi Datastore, SDK mengandalkan cron job internal untuk memastikan bahwa tugas apa pun yang gagal diantrekan selama commit datastore pada akhirnya akan diproses.
Untuk menangani tugas transaksional push queue, buat atau perbarui file cron.yaml Anda
untuk memanggil pemroses internal secara berkala. Contoh:
cron:
- description: "Process push queue transactional tasks"
url: /_ah/cloudtask/sweep
schedule: every 30 minutes # Change this based on the usage pattern
Tambahkan pemetaan URL di file web.xml Anda untuk
com.google.apphosting.utils.servlet.SweeperServlet, atau
com.google.apphosting.utils.servlet.jakarta.SweeperServlet untuk Java 17 dan
runtime Jakarta EE yang lebih baru.
<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>