Mengelola antrean dan tugas

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

  1. Pastikan Anda sudah memiliki antrean Cloud Tasks. Untuk mengetahui informasi selengkapnya, lihat Membuat antrean Cloud Tasks.
  2. 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

  1. Di konsol Google Cloud , buka halaman Cloud Tasks > Queues.

    Buka Antrean

  2. Klik nama antrean untuk tugas yang ingin Anda hapus.

  3. Pilih kotak centang untuk tugas yang ingin Anda hapus.

  4. Klik Hapus tugas.

  5. 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 hapus
  • QUEUE_ID: nama antrean tempat tugas berada
  • LOCATION: 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 berada
  • TASK_NAME: nama tugas yang ingin Anda hapus
  • PROJECT_ID: Project ID Google CloudAnda
  • LOCATION: 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_ID
  • PROJECT_ID: Project ID Google CloudAnda
  • REGION: region tempat antrean berada—misalnya, us-central1
  • QUEUE_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

  1. Di konsol Google Cloud , buka halaman Cloud Tasks > Queues.

    Buka Antrean

  2. Klik nama antrean untuk tugas yang ingin Anda hapus.

  3. Klik Purge queue.

  4. 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 hapus
  • LOCATION: 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 hapus
  • PROJECT_ID: Project ID Google CloudAnda
  • LOCATION: 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

  1. Di konsol Google Cloud , buka halaman Cloud Tasks > Queues.

    Buka Antrean

  2. Centang kotak untuk antrean yang ingin Anda jeda atau lanjutkan.

  3. Untuk menjeda antrean, klik Pause queue, lalu klik Pause pada dialog.

  4. Untuk melanjutkan antrean yang dijeda, klik Resume queue.

gcloud

  1. 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 jeda
    • LOCATION: region tempat antrean di-deploy—misalnya, us-central1
  2. Lanjutkan antrean menggunakan perintah gcloud tasks queues resume:

    gcloud tasks queues resume QUEUE_ID \
        --location=LOCATION

REST

  1. 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 jeda
    • PROJECT_ID: Project ID Google CloudAnda
    • LOCATION: 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"
    }
    

  2. 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 lanjutkan
    • PROJECT_ID: Project ID Google CloudAnda
    • LOCATION: 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

  1. Di konsol Google Cloud , buka halaman Cloud Tasks > Queues.

    Buka Antrean

    Semua antrean di project Google Cloud Anda akan dicantumkan.

  2. 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:

Untuk menghapus antrean, gunakan konsol Google Cloud , gcloud CLI, atau Cloud Tasks API:

Konsol

  1. Di konsol Google Cloud , buka halaman Cloud Tasks > Queues.

    Buka Antrean

  2. Centang kotak untuk antrean yang ingin Anda hapus.

  3. Klik Delete queue.

  4. 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 hapus
  • LOCATION: 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 hapus
  • PROJECT_ID: Project ID Google CloudAnda
  • LOCATION: 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.

Langkah berikutnya