Membuat Pull Queue

Halaman ini menjelaskan cara membuat pull queue. Anda harus membuat antrean sebelum menambahkan tugas ke dalamnya. Halaman ini juga menjelaskan cara menjeda atau menghapus antrean.

API ini didukung untuk runtime generasi pertama dan dapat digunakan saat mengupgrade ke runtime generasi kedua yang sesuai. Jika Anda mengupdate ke runtime App Engine Java 11/17, lihat panduan migrasi guna mempelajari opsi migrasi untuk layanan paket lama yang Anda miliki.

Menentukan antrean dengan queue.yaml

Anda dapat menentukan pull queue menggunakan file queue.yaml untuk aplikasi Anda. Prosesnya sama seperti membuat push queue bernama, dengan perintah khusus, mode: pull, yang ditambahkan ke file.

queue:
- name: my-queue-name
  mode: pull

Anda dapat menggunakan perintah gcloud gcloud CLI untuk mengupload file.

gcloud app deploy queue.yaml

Catatan: Jika Anda menggunakan akun layanan untuk mengelola autentikasi guna men-deploy file konfigurasi antrean, file tersebut harus memiliki izin serviceusage.services.list. Izin ini dapat ditambahkan menggunakan peran serviceusage.serviceUsageViewer atau dengan membuat peran khusus menggunakan izin tersebut.

Perhatian: Pembuatan antrean untuk layanan Task Queue juga dapat dikelola menggunakan metode Pengelolaan Antrean yang tersedia langsung melalui Cloud Tasks API, tetapi menggabungkan metode upload queue.yaml dengan metode Pengelolaan Antrean dapat memberikan hasil yang tidak terduga dan tidak direkomendasikan. Untuk informasi selengkapnya, lihat Ringkasan Pengelolaan Antrean dan queue.yaml. Perhatikan juga bahwa mengupload file queue.yaml melalui gcloud CLI di bawah versi 332.0.0 menggunakan antarmuka layanan yang sudah tidak digunakan lagi. Mulai 2022-09-20, upaya untuk menggunakan metode upload dapat gagal dengan error server. Untuk mengatasi hal ini, pastikan Cloud Tasks API diaktifkan di project Anda dan gcloud CLI telah diupdate ke setidaknya versi 332.0.0.

Menonaktifkan antrean

Anda dapat menonaktifkan atau menjeda antrean dengan menghapus definisinya dari file konfigurasi antrean, lalu mengupload file yang telah diperbarui.

Setelah file yang diperbarui diupload, antrean disetel ke "dinonaktifkan" dan kecepatannya ditetapkan ke 0. Setiap tugas yang berada dalam antrean atau tugas baru yang ditambahkan ke antrean tidak akan diproses. Anda dapat mengaktifkan kembali antrean yang dinonaktifkan dengan mengupload file antrean baru dengan antrean yang telah ditentukan.

Anda juga dapat menjeda antrean dari dalam halaman Cloud Tasks di konsol Google Cloud.

Menghapus antrean

Untuk menghapus kolom, Anda harus menonaktifkannya terlebih dahulu.

1. Hapus definisi antrean dari file konfigurasi antrean Anda.

2. Upload file yang diubah.

   gcloud app deploy queue.yaml
   

Setelah antrean dinonaktifkan, gunakan konsol Google Cloud untuk menghapusnya.

1. Di konsol Google Cloud, pilih antrean.

   Buka Cloud Tasks

2. Klik Delete queue.

Jika menghapus antrean dari konsol Google Cloud, Anda harus menunggu 7 hari sebelum membuat ulang dengan nama yang sama.

Penting: Server pengembangan lokal (dev_appserver) tidak mendukung pull queue. Untuk menguji pull queue dan memastikan Anda memiliki detail konfigurasi yang benar, Anda harus mengirim file konfigurasi antrean ke lingkungan staging App Engine.

Langkah selanjutnya

Pelajari cara membuat tugas.