Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
ID region
REGION_ID adalah kode singkat yang ditetapkan Google berdasarkan region yang Anda pilih saat membuat aplikasi. Kode ini tidak sesuai dengan negara atau provinsi, meskipun beberapa ID region mungkin tampak mirip dengan kode negara dan provinsi yang umum digunakan. Untuk aplikasi yang dibuat setelah Februari 2020, REGION_ID.r disertakan dalam URL App Engine. Untuk aplikasi lama yang dibuat sebelum tanggal tersebut, ID region bersifat opsional dalam URL.
File konfigurasi queue.yaml digunakan untuk membuat dan mengonfigurasi hampir semua task queue
yang digunakan aplikasi Anda. Semua aplikasi App Engine dilengkapi dengan push queue yang telah dikonfigurasi secara otomatis bernama default. Meskipun tidak membuat antrean default sendiri, Anda dapat menambahkan antrean lain atau mengubah konfigurasi antrean default menggunakan file queue.yaml.
Untuk mengonfigurasiAnda dapat menggunakan metode queue.yaml atau Pengelolaan Antrean dari Cloud Tasks, tetapi tidak keduanya secara bersamaan. Menggabungkan metode upload queue.yaml dengan metode Pengelolaan Antrean dapat memberikan hasil yang tidak terduga dan tidak direkomendasikan.
Contoh
Berikut contoh dasar yang menentukan antrean bernama dan mengganti kecepatan pemrosesan default:
queue:
- name: my-push-queue
rate: 1/s
Berikut adalah contoh yang lebih kompleks dari konfigurasi queue.yaml yang menunjukkan penyiapan jumlah percobaan tugas dan mengubah kecepatan pemrosesan default.
File queue.yaml adalah file YAML yang perintah root-nya adalah queue.
Perintah ini berisi nol atau beberapa antrean yang diberi nama. Setiap definisi antrean dapat menentukan elemen berikut:
Elemen
Deskripsi
bucket_size (push queue)
Opsional. Task queue menggunakan algoritma token bucket untuk mengontrol laju
eksekusi tugas. Setiap antrean bernama memiliki token bucket yang menyimpan token,
hingga jumlah maksimum yang ditentukan oleh nilai bucket_size. Setiap kali
aplikasi Anda menjalankan suatu tugas, satu token akan dihapus dari bucket.
Anda akan terus memproses tugas dalam antrean sampai bucket antrean
kehabisan token. App Engine mengisi ulang bucket dengan token baru
secara terus-menerus berdasarkan laju yang Anda tentukan untuk antrean tersebut.
Ukuran bucket membatasi seberapa cepat antrean diproses saat banyak tugas
dalam antrean dan kapasitasnya tinggi. Nilai maksimum untuk ukuran bucket
adalah 500. Hal ini memungkinkan Anda memperoleh kecepatan yang tinggi sehingga pemrosesan
dimulai sesaat setelah tugas diantrekan, tetapi tetap membatasi penggunaan resource saat
banyak tugas diantrekan dalam waktu singkat.
Jika Anda tidak menentukan bucket_size untuk antrean,
nilai defaultnya adalah 5. Sebaiknya tetapkan ke nilai yang lebih besar
karena ukuran defaultnya mungkin terlalu kecil untuk banyak kasus penggunaan. Misalnya, Anda dapat menentukan ukuran bucket berdasarkan
kecepatan pemrosesan.
Untuk informasi selengkapnya tentang elemen ini, lihat deskripsi komparatif
max_burst_size
dalam referensi Cloud Tasks API.
max_concurrent_requests (push queue)
Opsional.
Menetapkan jumlah tugas maksimum yang dapat dijalankan secara bersamaan
dari antrean yang ditentukan. Nilainya berupa bilangan bulat. Secara default,
batasnya adalah 1.000 tugas per antrean. Batas atas yang direkomendasikan adalah 5.000
tugas per antrean. Perhatikan bahwa antrean mungkin meningkat perlahan saat
pertama kali dibuat atau jika tidak ada aktivitas selama beberapa waktu.
Membatasi jumlah tugas serentak akan memberi Anda lebih banyak kontrol atas
tingkat eksekusi antrean dan dapat mencegah terlalu banyak tugas
dijalankan sekaligus. Hal ini juga dapat mencegah pertentangan datastore dan membuat
resource tersedia untuk antrean lain atau pemrosesan online.
Untuk informasi selengkapnya tentang elemen ini, lihat deskripsi komparatif max_concurrent_dispatches dalam referensi Cloud Tasks API.
name
Wajib.
Nama antrean.
Nama antrean dapat berisi huruf besar dan kecil, angka, serta tanda hubung. Panjang maksimum nama antrean adalah 100 karakter.
Semua aplikasi memiliki push queue dengan nama default. Antrean ini memiliki kecepatan yang telah ditetapkan sebelumnya, yaitu 5 tugas per detik. Perlu diperhatikan bahwa antrean default ini tidak ditampilkan di Google Cloud console hingga pertama kali digunakan atau dikonfigurasi.
Anda dapat mengonfigurasi antrean default, termasuk mengubah tarif default, dengan menentukan antrean bernama `default` di file queue.yaml Anda.
rate (push queue)
Wajib.
Seberapa sering tugas diproses di antrean ini. Nilainya berupa angka
yang diikuti garis miring dan unit waktu, dengan unitnya adalah
s untuk detik, m untuk menit, h
untuk jam, atau d untuk hari. Misalnya, nilai 5/m menyatakan bahwa tugas akan diproses dengan kecepatan 5 kali per menit. Nilai maksimum untuk rate adalah 500/s.
Jika jumlahnya 0 (seperti 0/s), antrean dianggap "dijeda" dan tidak ada tugas yang diproses.
Untuk mengetahui informasi selengkapnya tentang elemen ini, lihat deskripsi komparatif max_dispatches_per_second dalam referensi Cloud Tasks API.
retry_parameters
Opsional.
Mengonfigurasi upaya percobaan ulang untuk tugas yang gagal dalam push queue. Penambahan ini memungkinkan Anda menentukan jumlah maksimum untuk mencoba kembali tugas yang gagal dalam antrean tertentu. Anda juga dapat menetapkan batas waktu untuk percobaan ulang dan mengontrol interval antar-percobaan.
Parameter percobaan ulang dapat berisi subelemen berikut:
task_retry_limit
Jumlah percobaan ulang. Misalnya, jika 0 ditetapkan dan tugas gagal, tugas tidak akan dicoba ulang sama sekali. Jika 1 ditentukan dan tugas gagal, tugas akan dicoba ulang sekali. Jika parameter ini tidak ditentukan, tugas akan dicoba ulang tanpa batas. Jika task_retry_limit ditetapkan dengan task_age_limit, tugas akan dicoba lagi hingga kedua batas tercapai.
task_age_limit (push queue)
Batas waktu untuk mencoba kembali tugas yang gagal, yang diukur dari saat
tugas pertama kali dijalankan. Nilainya adalah angka yang diikuti oleh unit waktu, dengan unitnya adalah s untuk detik, m untuk menit, h untuk jam, atau d untuk hari.
Misalnya, nilai 5d menentukan batas lima hari setelah upaya eksekusi pertama tugas. Jika parameter ini
tidak ditentukan, tugas akan dicoba ulang tanpa batas. Jika ditentukan dengan
task_retry_limit, App Engine akan mencoba kembali tugas hingga
kedua batas tercapai.
min_backoff_seconds (push queue)
Jumlah detik minimum untuk menunggu sebelum mencoba kembali tugas setelah
gagal. Nilai defaultnya adalah 0.1.
max_backoff_seconds (push queue)
Jumlah detik maksimum untuk menunggu sebelum mencoba kembali tugas setelah
gagal. Nilai defaultnya adalah 3600.
max_doublings (push queue)
Frekuensi maksimum interval antara percobaan ulang tugas yang gagal
akan dilipatgandakan sebelum peningkatan menjadi konstan. Konstanta
tersebut adalah: 2**max_doublings * min_backoff_seconds.
Nilai defaultnya adalah 16.
target (push queue)
Opsional.
String yang menyebutkan layanan/versi, versi frontend, atau backend,
untuk mengeksekusi semua tugas yang diantrekan ke antrean ini. Nilai defaultnya adalah string kosong.
String ini ditambahkan ke nama domain aplikasi Anda saat
membuat permintaan HTTP untuk tugas. Misalnya, jika ID aplikasi
adalah my-app dan Anda menetapkan target ke
my-version-dot-my-service, nama host URL akan ditetapkan ke
my-version-dot-my-service-dot-my-app.REGION_ID.r.appspot.com.
Jika target tidak ditentukan, tugas akan dipanggil pada versi aplikasi yang sama
tempat tugas tersebut diantrekan. Jadi, jika Anda mengantrekan
tugas dari versi aplikasi default tanpa menentukan target
di antrean, tugas tersebut akan dipanggil dalam versi aplikasi default.
Perlu diperhatikan bahwa jika versi aplikasi default berubah antara waktu
tugas diantrekan dan waktu eksekusinya, tugas
akan berjalan dalam versi default yang baru.
Jika Anda menggunakan layanan bersama dengan file
dispatch, permintaan HTTP tugas Anda mungkin ditangkap dan dialihkan
ke layanan lain.
Men-deploy file konfigurasi antrean
Menghapus antrean
Untuk menghapus antrean:
Hapus definisi antrean dari file queue.yaml Anda.
Upload perubahan ke file queue.yaml Anda.
Aplikasi gcloud men-deploy queue.yaml
Hapus antrean di konsol Google Cloud , pilih antrean, lalu klik Delete queue:
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-19 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eREGION_ID\u003c/code\u003e is a Google-assigned code based on the selected region when creating an app and is included in App Engine URLs for apps created after February 2020.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003equeue.yaml\u003c/code\u003e file is used to create and configure task queues, including the preconfigured \u003ccode\u003edefault\u003c/code\u003e queue, but should not be mixed with Queue Management methods to avoid unexpected results.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003equeue.yaml\u003c/code\u003e file contains definitions for one or multiple named queues, where each queue definition can specify elements like \u003ccode\u003ename\u003c/code\u003e, \u003ccode\u003erate\u003c/code\u003e, \u003ccode\u003ebucket_size\u003c/code\u003e, \u003ccode\u003emax_concurrent_requests\u003c/code\u003e, \u003ccode\u003eretry_parameters\u003c/code\u003e and \u003ccode\u003etarget\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003erate\u003c/code\u003e parameter in \u003ccode\u003equeue.yaml\u003c/code\u003e controls how often tasks are processed, with a maximum value of \u003ccode\u003e500/s\u003c/code\u003e, and can be set to \u003ccode\u003e0/s\u003c/code\u003e to pause the queue, while the \u003ccode\u003eretry_parameters\u003c/code\u003e allows to setup the maximum time and amount of retries.\u003c/p\u003e\n"],["\u003cp\u003eTo delete a queue, remove its definition from \u003ccode\u003equeue.yaml\u003c/code\u003e, upload the changes, and then delete the queue in the Google Cloud console, where you must wait 7 days before reusing the same name.\u003c/p\u003e\n"]]],[],null,["# queue.yaml Reference\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\n### Region ID\n\nThe \u003cvar translate=\"no\"\u003eREGION_ID\u003c/var\u003e is an abbreviated code that Google assigns\nbased on the region you select when you create your app. The code does not\ncorrespond to a country or province, even though some region IDs may appear\nsimilar to commonly used country and province codes. For apps created after\nFebruary 2020, \u003cvar translate=\"no\"\u003eREGION_ID\u003c/var\u003e`.r` is included in\nApp Engine URLs. For existing apps created before this date, the\nregion ID is optional in the URL.\n\nLearn more\n[about region IDs](/appengine/docs/legacy/standard/python/how-requests-are-routed#region-id). \nOK \nGo Java Node.js PHP Python Ruby\n\nThe `queue.yaml` configuration file is used to create and configure almost all\nof the task queues\n\n\nyour app uses. All App Engine apps come with\nan automatically preconfigured push queue named `default`. Although you do not\ncreate the `default` queue yourself, you can add other queues or change the\nconfiguration of the `default` queue using the `queue.yaml` file.\n\nTo configure\n\nyou can use either `queue.yaml` or\n[Queue Management](/tasks/docs/queue-yaml) methods from Cloud Tasks, but\n[not both](/tasks/docs/queue-yaml#pitfalls) at the same time. Mixing the\n`queue.yaml` upload method with Queue Management methods can produce unexpected\nresults and is not recommended.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| **Caution:** When uploading a `queue.yaml` file via the gcloud CLI below version `332.0.0` uses a deprecated interface to the service. Starting on `2022-09-20`, attempts to use the upload method can fail with server errors. To resolve this, make sure the Cloud Tasks API is enabled in your project and your gcloud CLI is updated to at least version `332.0.0`.\n\nExample\n-------\n\nThe following a basic example that defines a named queue and overrides the\ndefault processing rate: \n\n queue:\n - name: my-push-queue\n rate: 1/s\n\nThe following is a more complex example of a `queue.yaml` configuration that\ndemonstrates setting up the number of task tries and modifying the default\nprocessing rate. \n\n queue:\n - name: fooqueue\n rate: 1/s\n retry_parameters:\n task_retry_limit: 7\n task_age_limit: 2d\n - name: barqueue\n rate: 1/s\n retry_parameters:\n min_backoff_seconds: 10\n max_backoff_seconds: 200\n max_doublings: 0\n - name: bazqueue\n rate: 1/s\n retry_parameters:\n min_backoff_seconds: 10\n max_backoff_seconds: 200\n max_doublings: 3\n\nSyntax\n------\n\nThe `queue.yaml` file is a YAML file whose root directive is `queue`.\nThis directive contains zero or more named queues. Each queue definition can\nspecify the following elements:\n\nDeploying the queue configuration file\n--------------------------------------\n\nDeleting queues\n---------------\n\nTo delete a queue:\n\n1. Remove the queue definition from your `queue.yaml` file.\n\n2. Upload the change to your `queue.yaml` file.\n\n gcloud app deploy queue.yaml\n3. Delete the queue in the Google Cloud console, select the queue and click\n **Delete queue**:\n\n [Go to the Task queues page](https://console.cloud.google.com/appengine/taskqueues)\n\nIf you delete a queue from the Google Cloud console, you must wait 7 days\nbefore recreating with the same name."]]
