Dengan Cloud Tasks, Anda dapat mengontrol eksekusi workload asinkron, menjeda pemrosesan antrean, dan memecahkan masalah alur tugas aktif. Anda dapat mengonfigurasi dan memelihara antrean dan tugas menggunakan konsol Google Cloud , Google Cloud CLI, atau Cloud Tasks API.
Sebelum memulai
- Pastikan Anda sudah memiliki antrean Cloud Tasks. Untuk mengetahui informasi selengkapnya, lihat Membuat antrean Cloud Tasks.
- Pastikan Anda memiliki peran Identity and Access Management (IAM) yang diperlukan untuk mengelola antrean dan tugas, seperti Cloud Tasks Admin (
roles/cloudtasks.admin), Cloud Tasks Queue Admin (roles/cloudtasks.queueAdmin), atau Cloud Tasks Task Deleter (roles/cloudtasks.taskDeleter).
Menghapus tugas dari antrean
Anda dapat menghapus tugas jika tugas tersebut dijadwalkan atau dikirim. Misalnya, Anda mungkin perlu menghapus tugas yang tidak dapat diselesaikan dengan sukses, berapa kali pun tugas tersebut dicoba ulang. Anda tidak dapat menghapus tugas jika tugas tersebut telah berhasil diselesaikan atau jika tugas tersebut telah kehabisan percobaan ulang setelah terus-menerus gagal. Tugas akan otomatis dihapus jika batas retensi tugas maksimum tercapai.
Konsol
Di konsol Google Cloud , buka halaman Cloud Tasks > Queues.
Klik nama antrean untuk tugas yang ingin Anda hapus.
Pilih kotak centang untuk tugas yang ingin Anda hapus.
Klik Hapus tugas.
Saat diminta, klik Hapus.
gcloud
Hapus tugas menggunakan perintah
gcloud tasks delete:
gcloud tasks delete TASK_NAME \ --queue=QUEUE_ID \ --location=LOCATION
Ganti kode berikut:
TASK_NAME: ID atau nama resource lengkap tugas yang ingin Anda hapusQUEUE_ID: nama antrean tempat tugas beradaLOCATION: region tempat antrean di-deploy—misalnya,us-central1
REST
Untuk menghapus tugas, gunakan metode
projects.locations.queues.tasks.delete.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
QUEUE_ID: nama antrean tempat tugas beradaTASK_NAME: nama tugas yang ingin Anda hapusPROJECT_ID: Project ID Google CloudAndaLOCATION: region tempat antrean berada—misalnya,us-central1
Isi permintaan harus kosong.
Untuk mengirim permintaan Anda, luaskan salah satu opsi berikut:
Jika berhasil, isi respons akan kosong.
Menghapus batch tugas dari antrean
Anda dapat menghapus batch tugas dari antrean menggunakan metode projects.locations.queues.tasks.batchDelete untuk menghapus daftar nama tugas.
Perhatikan hal berikut:
Semua tugas harus dihapus dari antrean yang sama.
Ada batasan jumlah tugas yang dapat dihapus dalam satu batch. Untuk mengetahui informasi selengkapnya, lihat Kuota dan batas.
Permintaan batch, yang menggabungkan operasi individual menjadi satu permintaan, tidak bersifat atomik karena beberapa operasi yang ada di dalam batch mungkin gagal, sementara operasi lainnya berhasil.
Anda hanya dapat menghapus tugas jika tugas tersebut dijadwalkan atau dikirim. Anda tidak dapat menghapus tugas jika tugas tersebut telah berhasil diselesaikan atau jika percobaan ulang telah habis setelah terus-menerus gagal. Tugas akan otomatis dihapus jika batas retensi tugas maksimum tercapai.
Anda juga dapat membuat batch tugas. Untuk mengetahui informasi selengkapnya, lihat Membuat batch tugas.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
TASK_NAME: nama tugas yang akan dihapus dengan format berikut:projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks/TASK_IDPROJECT_ID: Project ID Google CloudAndaREGION: region tempat antrean berada—misalnya,us-central1QUEUE_ID: nama antrean yang memiliki tugas
Isi permintaan berisi daftar nama tugas.
Meminta isi JSON:
{
"names": [
"TASK_NAME"
]
}
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Jika berhasil, isi respons akan memuat instance
Operation.
{
"name": "projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.tasks.v2.BatchDeleteTasksMetadata"
},
"done": false
}
Menghapus permanen semua tugas dari antrean
Anda dapat menghapus semua tugas dari antrean dengan menghapusnya secara permanen. Semua tugas yang dibuat sebelum panggilan penghapusan akan dihapus secara permanen. Namun, operasi penghapusan permanen dapat memerlukan waktu hingga satu menit untuk diterapkan dan tugas mungkin dikirim sebelum penghapusan permanen diterapkan.
Konsol
Di konsol Google Cloud , buka halaman Cloud Tasks > Queues.
Klik nama antrean untuk tugas yang ingin Anda hapus.
Klik Purge queue.
Pada layar perintah yang muncul, klik Purge.
gcloud
Hapus permanen antrean menggunakan perintah
gcloud tasks queues purge:
gcloud tasks queues purge QUEUE_ID \ --location=LOCATION
Ganti kode berikut:
QUEUE_ID: nama antrean yang ingin Anda hapusLOCATION: region tempat antrean di-deploy—misalnya,us-central1
REST
Untuk menghapus total antrean, gunakan metode
projects.locations.queues.purge.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
QUEUE_ID: nama antrean yang ingin Anda hapusPROJECT_ID: Project ID Google CloudAndaLOCATION: region tempat antrean di-deploy—misalnya,us-central1
Isi permintaan harus kosong.
Untuk mengirim permintaan Anda, luaskan salah satu opsi berikut:
Jika berhasil, isi respons akan memuat instance
Queue:
{
"name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
"rateLimits": {
"maxDispatchesPerSecond": 500,
"maxBurstSize": 100,
"maxConcurrentDispatches": 1000
},
"retryConfig": {
"maxAttempts": 100,
"minBackoff": "0.100s",
"maxBackoff": "3600s",
"maxDoublings": 16
},
"state": "RUNNING",
"purgeTime": "2025-03-28T13:06:30.110255Z"
}
Menjeda atau melanjutkan antrean
Anda dapat menjeda atau melanjutkan antrean. Menjeda antrean akan menghentikan eksekusi dan pengiriman tugas. Anda masih dapat membuat tugas dan mengirim atau menambahkannya ke antrean, tetapi tugas tersebut tidak akan diproses hingga antrean dilanjutkan. Saat Anda melanjutkan antrean, Cloud Tasks akan mulai mengirimkan tugas yang tertunda tanpa urutan eksekusi yang ditentukan. Jika Anda melanjutkan antrean traffic tinggi dengan backlog yang besar, ikuti panduan peningkatan untuk mencegah kelebihan beban target.
Konsol
Di konsol Google Cloud , buka halaman Cloud Tasks > Queues.
Centang kotak untuk antrean yang ingin Anda jeda atau lanjutkan.
Untuk menjeda antrean, klik Pause queue, lalu klik Pause pada dialog.
Untuk melanjutkan antrean yang dijeda, klik Resume queue.
gcloud
Jeda antrean menggunakan perintah
gcloud tasks queues pause:gcloud tasks queues pause QUEUE_ID \ --location=LOCATION
Ganti kode berikut:
QUEUE_ID: nama antrean yang ingin Anda jedaLOCATION: region tempat antrean di-deploy—misalnya,us-central1
Lanjutkan antrean menggunakan perintah
gcloud tasks queues resume:gcloud tasks queues resume QUEUE_ID \ --location=LOCATION
REST
Untuk menjeda antrean, gunakan metode
projects.locations.queues.pause.Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
QUEUE_ID: nama antrean yang ingin Anda jedaPROJECT_ID: Project ID Google CloudAndaLOCATION: region tempat antrean di-deploy—misalnya,us-central1
Isi permintaan harus kosong.
Untuk mengirim permintaan Anda, luaskan salah satu opsi berikut:
Jika berhasil, isi respons akan memuat instance
Queue:{ "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID", "rateLimits": { "maxDispatchesPerSecond": 500, "maxBurstSize": 100, "maxConcurrentDispatches": 1000 }, "retryConfig": { "maxAttempts": 100, "minBackoff": "0.100s", "maxBackoff": "3600s", "maxDoublings": 16 }, "state": "PAUSED" }Untuk melanjutkan antrean, gunakan metode
projects.locations.queues.resume.Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
QUEUE_ID: nama antrean yang ingin Anda lanjutkanPROJECT_ID: Project ID Google CloudAndaLOCATION: region tempat antrean di-deploy—misalnya,us-central1
Isi permintaan harus kosong.
Untuk mengirim permintaan Anda, luaskan salah satu opsi berikut:
Jika berhasil, isi respons akan memuat instance
Queue:{ "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID", "rateLimits": { "maxDispatchesPerSecond": 500, "maxBurstSize": 100, "maxConcurrentDispatches": 1000 }, "retryConfig": { "maxAttempts": 100, "minBackoff": "0.100s", "maxBackoff": "3600s", "maxDoublings": 16 }, "state": "RUNNING" }
Membuat daftar antrean
Anda dapat mencantumkan antrean. Saat mencantumkan antrean, beberapa detail pembatasan kapasitas dan parameter percobaan ulang akan ditampilkan. Perhatikan bahwa kolom berikut setara:
- Max rate (Konsol),
MAX_RATE(gcloud),maxDispatchesPerSecond(REST) Max concurrent (Konsol),
MAX_NUM_OF_TASKS(gcloud),maxConcurrentDispatches(REST)
Konsol
Di konsol Google Cloud , buka halaman Cloud Tasks > Queues.
Semua antrean di project Google Cloud Anda akan dicantumkan.
Untuk mengetahui detail selengkapnya, klik nama antrean, lalu klik tab Configuration.
Detail parameter pembatasan kapasitas dan percobaan ulang akan ditampilkan.
gcloud
Cantumkan antrean menggunakan perintah
gcloud tasks queues list:
gcloud tasks queues list \ --location=LOCATION
Ganti LOCATION dengan
region tempat antrean
di-deploy—misalnya, us-central1. Jika lokasi tidak ditentukan, lokasi aplikasi App Engine project Google Cloud Anda akan digunakan jika ada; jika tidak, Anda harus menentukan lokasi.
Outputnya akan mirip dengan berikut ini:
QUEUE_NAME: my-queue STATE: PAUSED MAX_NUM_OF_TASKS: 1000 MAX_RATE (/sec): 500.0 MAX_ATTEMPTS: 100 ...
REST
Untuk mencantumkan antrean, gunakan metode
projects.locations.queues.list.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
PROJECT_ID: project ID Google Cloud Anda.LOCATION: region tempat antrean dibuat—misalnya,us-central1.
Untuk mengirim permintaan Anda, luaskan salah satu opsi berikut:
Jika berhasil, isi respons akan berisi instance resource Queue dan responsnya akan mirip dengan berikut ini:
{
"queues": [
{
"name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
"rateLimits": {
"maxDispatchesPerSecond": 500,
"maxBurstSize": 100,
"maxConcurrentDispatches": 1000
},
"retryConfig": {
"maxAttempts": 100,
"minBackoff": "0.100s",
"maxBackoff": "3600s",
"maxDoublings": 16
},
"state": "PAUSED",
"purgeTime": "2025-03-28T13:37:32.292552Z"
},
...
],
"nextPageToken": "CjQKCHppcHBlcjIAEgwI9-GExAYQ_oDc1AMaGioLeWlrZXMtYWdhaW4yC3VzLWNlbnRyYWwx"
}
Menghapus antrean
Anda dapat menghapus antrean apa pun saat tidak lagi membutuhkannya, kecuali
antrean default App Engine.
Setelah menghapus antrean, Anda harus menunggu 3 hari sebelum membuat ulang dengan nama yang sama. Periode tunggu ini berlaku untuk antrean yang dihapus melalui antarmuka apa pun,
termasuk konsol Google Cloud , gcloud CLI, REST atau
RPC API, atau Terraform. Hal ini mencegah perilaku yang tidak terduga dalam tugas yang
sedang dieksekusi pada saat penghapusan dan menghindari kegagalan proses internal selama
siklus penghapusan dan pembuatan ulang.
Selama periode tombstone hingga 3 hari ini, permintaan pembuatan antrean mungkin
tampak berhasil tanpa membuat ulang antrean. Untuk mengonfirmasi bahwa antrean dengan nama yang sama telah dibuat ulang, ambil antrean menggunakan perintah gcloud tasks queues describe atau metode projects.locations.queues.get. Respons yang berhasil (200 OK) mengonfirmasi bahwa antrean telah dibuat ulang.
Untuk menghapus tugas, mengubah konfigurasi antrean, atau mengelola antrean di pipeline CI/CD tanpa kehilangan antrean atau memicu masa tunggu 3 hari, gunakan alternatif berikut, bukan menghapus dan membuat ulang antrean:
Hapus permanen antrean: hapus semua tugas dalam antrean sambil tetap mengaktifkan antrean dengan menghapus permanen semua tugas dari antrean menggunakan perintah
gcloud tasks queues purgeatau metodeprojects.locations.queues.purge.Perbarui antrean di tempat: ubah batas kapasitas, parameter percobaan ulang, atau perutean pada antrean yang ada menggunakan perintah
gcloud tasks queues updateatau metodeprojects.locations.queues.patch. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi perutean, batas, dan percobaan ulang antrean.Menjeda antrean: menghentikan sementara pengiriman tugas sambil mempertahankan tugas dalam antrean dengan menjeda antrean menggunakan perintah
gcloud tasks queues pauseatau metodeprojects.locations.queues.pause.Konfigurasikan guardrail siklus proses: cegah penghapusan antrean yang tidak disengaja selama deployment otomatis dengan mengonfigurasi proteksi dari penghapusan di template infrastructure as code, seperti menetapkan
prevent_destroy = truedi bloklifecycleTerraform.
Untuk menghapus antrean, gunakan konsol Google Cloud , gcloud CLI, atau Cloud Tasks API:
Konsol
Di konsol Google Cloud , buka halaman Cloud Tasks > Queues.
Centang kotak untuk antrean yang ingin Anda hapus.
Klik Delete queue.
Saat diminta, masukkan nama antrean, lalu klik Confirm.
gcloud
Hapus antrean menggunakan perintah
gcloud tasks queues delete:
gcloud tasks queues delete QUEUE_ID \ --location=LOCATION
Ganti kode berikut:
QUEUE_ID: ID atau ID yang sepenuhnya memenuhi syarat dari antrean yang ingin Anda hapusLOCATION: region tempat antrean di-deploy—misalnya,us-central1
gcloud CLI akan meminta konfirmasi sebelum menghapus antrean, kecuali jika Anda meneruskan flag --quiet.
REST
Untuk menghapus antrean, gunakan metode
projects.locations.queues.delete.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
QUEUE_ID: nama antrean yang ingin Anda hapusPROJECT_ID: Project ID Google CloudAndaLOCATION: region tempat antrean di-deploy—misalnya,us-central1
Isi permintaan harus kosong.
Untuk mengirim permintaan Anda, luaskan salah satu opsi berikut:
Jika berhasil, isi respons akan kosong.