Memigrasikan pull queue ke Pub/Sub

Halaman ini menjelaskan cara memigrasikan kode pull queue dari Task Queue ke Pub/Sub. Pub/Sub kini merupakan cara yang lebih disukai untuk melakukan tugas pull queue di App Engine.

Jika aplikasi Anda menggunakan pull queue dan push queue, gunakan panduan ini untuk memigrasikan pull queue Anda ke Pub/Sub sebelum memigrasikan push queue ke Cloud Tasks layanan push queue baru. Sebaiknya jangan memigrasikan pull queue Anda setelah memigrasikan push queue ke Cloud Tasks karena penggunaan file queue.yaml yang diperlukan cenderung menyebabkan perilaku yang tidak terduga dengan Cloud Tasks.

Fitur yang saat ini tidak tersedia di Pub/Sub

Fitur Task Queue berikut saat ini tidak tersedia di Pub/Sub:

  • Pengelompokan berdasarkan tag
  • Penghapusan duplikat otomatis

Harga dan kuota

Memigrasikan pull queue ke Pub/Sub dapat memengaruhi harga dan kuota untuk aplikasi Anda.

Harga

Pub/Sub memiliki pricing sendiri. Seperti halnya Task Queue, mengirim permintaan ke aplikasi App Engine dengan Pub/Sub dapat menyebabkan aplikasi Anda dikenakan biaya.

Kuota

quotas Pub/Sub berbeda dari kuota untuk Task Queue. Seperti halnya Task Queue, mengirim permintaan ke aplikasi App Engine dari Pub/Sub dapat memengaruhi kuota permintaan App Engine Anda.

Sebelum bermigrasi

Bagian berikut membahas langkah-langkah penyiapan sebelum memigrasikan pull queue Anda ke Pub/Sub.

Mengaktifkan Pub/Sub API

Untuk mengaktifkan Pub/Sub API, klik Aktifkan di Pub/Sub API paa Library API. Jika melihat tombol Kelola dan bukan tombol Aktifkan, berarti sebelumnya Anda telah mengaktifkan Pub/Sub API untuk project tersebut dan tidak perlu melakukan tindakan ini lagi.

Mengautentikasi aplikasi ke Pub/Sub API

Anda harus mengautentikasi aplikasi ke Pub/Sub API. Bagian ini membahas autentikasi untuk dua kasus penggunaan yang berbeda.

Untuk mengembangkan atau menguji aplikasi secara lokal, sebaiknya gunakan akun layanan. Untuk petunjuk tentang cara menyiapkan akun layanan dan menghubungkannya ke aplikasi Anda, baca Mendapatkan dan memberikan kredensial akun layanan secara manual.

Untuk men-deploy aplikasi di App Engine, Anda tidak perlu memberikan autentikasi baru. Kredensial Default Aplikasi (ADC) menyimpulkan detail autentikasi untuk aplikasi App Engine.

Mendownload Google Cloud CLI

Download dan instal Google Cloud CLI untuk menggunakan gcloud CLI dengan Pub/Sub API jika sebelumnya Anda belum menginstalnya. Jalankan perintah berikut dari terminal Anda jika Anda sudah menginstal Google Cloud CLI.

gcloud components update

Mengimpor Library Klien Cloud

Ikuti petunjuk Pub/Sub terkait cara menginstal library klien untuk menggunakan library klien dengan aplikasi Anda.

Pub/Sub dan pull queue

Perbandingan fitur

Pub/Sub mengirimkan tugas ke worker melalui hubungan penayang/pelanggan. Langganan pull di Pub/Sub menyerupai pull queue di Task Queue karena pelanggan mengambil pesan dari topik. Tabel di bawah ini mencantumkan fitur inti untuk pull queue di Task Queue dan fitur terkait untuk langganan pull di Pub/Sub.

Fitur Task Queue Fitur Pub/Sub
Antrean Topik
Tugas Pesan
Pekerja Pelanggan

Untuk mempelajari arsitektur Pub/Sub lebih lanjut, baca Cloud Pub/Sub: Layanan Pesan Berskala Google.

Perbandingan alur kerja

Di bawah ini adalah perbandingan alur kerja standar untuk pull queue di Task Queue dan langganan pull di Pub/Sub.

Alur kerja Task Queue Alur kerja Pub/Sub
Anda membuat pull queue Anda membuat topik dan membuat pelanggan Anda (yaitu worker) berlangganan ke topik tersebut
Anda membuat dan menambahkan tugas ke dalam antrean Anda membuat pesan dan memublikasikannya ke topik
Worker menyewakan tugas Pelanggan mengambil pesan dari topik
Worker memproses tugas Pelanggan memproses pesan
Worker menghapus tugas dari antrean Pelanggan mengonfirmasi pesan
Masa sewa berakhir Topik akan menghapus pesan saat semua pelanggannya telah mengonfirmasi pesan

Membuat langganan pull di Pub/Sub

Anda dapat menggunakan langganan pull Pub/Sub seperti pull queue Task Queue. Langganan suatu topik tidak akan habis masa berlakunya dan bisa ada secara bersamaan untuk beberapa worker. Artinya, pesan dapat diproses oleh lebih dari satu worker yang merupakan salah satu kasus penggunaan utama untuk Pub/Sub. Untuk membuat ulang pull queue Task Queue sebagai langganan pull Pub/Sub, buat topik untuk setiap worker dan pastikan hanya worker terkait saja yang berlangganan ke topik tersebut. Hal ini memastikan bahwa setiap pesan diproses oleh tepat satu worker seperti dalam Task Queue. Untuk mempelajari cara membuat dan mengelola langganan pull, baca mengelola topik dan langganan.

Menghapus pull queue

Setelah memigrasikan pull queue Task Queue ke langganan pull Pub/Sub, hapus pull queue dari Task Queue menggunakan file queue.yaml Anda. Sebaiknya hapus setiap pull queue sebelum memigrasikan yang berikutnya. Hal ini akan mencegah aplikasi menduplikasi tugas yang diterimanya dari langganan pull Pub/Sub baru saat Anda memigrasikan pull queue lainnya. Perlu diperhatikan bahwa dampak terhadap kuota deployment App Engine Anda bisa lebih signifikan apabila menghapus pull queue Task Queue satu per satu, dibandingkan dengan menghapus satu deployment.

Setelah menghapus semua pull queue dari Task Queue, Anda dapat menghapus file queue.yaml dari deployment aplikasi Anda di masa mendatang.

Jika aplikasi Anda hanya menggunakan pull queue, hapus semua referensi ke Task Queue API dalam kode Anda. Jika aplikasi menggunakan pull queue dan push queue, Anda dapat menghapus referensi ke Task Queue API yang ada di dalam file yang hanya menggunakan pull queue, atau menunggu hingga Anda memigrasikan push queue, lalu menghapus referensi ke Task Queue API dari semua file.

Langkah selanjutnya