Mengonfigurasi antrean Cloud Tasks

Halaman ini menjelaskan cara mengonfigurasi antrean Cloud Tasks menggunakan perintah gcloud dari Google Cloud CLI.

Ringkasan

Anda dapat mengonfigurasi antrean Cloud Tasks saat membuat antrean atau kapan saja setelahnya, dan konfigurasi akan berlaku untuk semua tugas dalam antrean tersebut.

Ada tiga aspek dasar untuk mengonfigurasi antrean:

Pemilihan rute tingkat antrean

Mengonfigurasi pemilihan rute di tingkat antrean akan mengganti pemilihan rute yang ditetapkan di tingkat tugas. Hal ini berguna jika Anda ingin menggunakan Cloud Tasks sebagai buffering di depan layanan target, atau jika Anda perlu mengubah pemilihan rute untuk semua tugas dalam antrean.

Pemilihan rute tingkat antrean berlaku untuk:

  • Tugas yang saat ini berada dalam antrean
  • Tugas yang ditambahkan ke antrean setelah pemilihan rute tingkat antrean ditetapkan

Batasan

Pemilihan rute tingkat antrean tidak kompatibel dengan kunci enkripsi yang dikelola pelanggan (CMEK) Cloud Key Management Service (Cloud KMS). Jika CMEK diaktifkan, Anda tidak dapat:

  • Membuat tugas di antrean yang memiliki pemilihan rute tingkat antrean
  • Menerapkan pemilihan rute tingkat antrean

Mengonfigurasi pemilihan rute tingkat antrean untuk tugas HTTP

Menerapkan pemilihan rute tingkat antrean

Anda dapat mengonfigurasi antrean untuk mengganti pemilihan rute tingkat tugas saat membuat atau memperbarui antrean. Untuk mengonfigurasi pemilihan rute tingkat antrean, tetapkan parameter uriOverride antrean ke rute pilihan Anda. Jika Anda menerapkan pemilihan rute tingkat antrean sebagai update ke antrean yang ada, jeda antrean sebelum menerapkan perubahan dan tunggu satu menit setelah menerapkan perubahan untuk melanjutkan antrean. Diperlukan waktu hingga satu menit agar konfigurasi baru diterapkan, jadi menunggu untuk melanjutkan antrean akan membantu mencegah tugas dikirim dengan konfigurasi lama.

Memperbarui atau menghapus perutean tingkat antrean

  1. Menjeda antrean.

    Konsol

    Untuk menjeda antrean menggunakan konsol Google Cloud:

    1. Buka halaman antrean Cloud Tasks di konsol.

      Buka halaman antrean Cloud Tasks

    2. Pilih nama antrean yang ingin dijeda, lalu klik Jeda antrean.

    3. Konfirmasi tindakan.

    gcloud

    gcloud tasks queues pause QUEUE_ID

    Ganti QUEUE_ID dengan ID antrean Anda.

  2. Perbarui atau hapus perutean tingkat antrean.

    • Untuk memperbarui pemilihan rute tingkat antrean, tetapkan parameter uriOverride ke rute yang diperbarui.

    • Untuk menghapus perutean tingkat antrean menggunakan REST atau RPC API:

      • REST API: Kirim permintaan patch untuk antrean dengan payload kosong dan parameter updateMask ditetapkan ke httpTarget.

      • RPC API: Kirim updateQueueRequest untuk antrean dengan payload kosong dan parameter update_mask ditetapkan ke http_target.

    Contoh berikut menggunakan REST API untuk memperbarui tugas host yang dirutekan ke:

    curl -X PATCH -d @- -i \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "Content-Type: application/json" \
"https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID?updateMask=httpTarget.uriOverride" << EOF
{
"httpTarget": {"uriOverride":{"host":"NEW_HOST"}}
}
EOF

    Ganti kode berikut:

    • PROJECT_ID: ID project Google Cloud Anda. Anda bisa mendapatkannya dengan menjalankan perintah berikut di terminal: 
      gcloud config get-value project
    • LOCATION: Lokasi antrean Anda.
    • QUEUE_ID: ID antrean Anda.

    • ACCESS_TOKEN: Token akses Anda. Anda bisa mendapatkannya dengan menjalankan perintah berikut di terminal:

      1. gcloud auth application-default login
      2. gcloud auth application-default print-access-token

    • NEW_HOST: Host baru yang Anda inginkan untuk dirutekan oleh antrean.

  3. Tunggu satu menit.

    Diperlukan waktu hingga satu menit agar konfigurasi baru diterapkan, sehingga menunggu untuk melanjutkan antrean akan membantu mencegah tugas dikirim dengan konfigurasi lama.

  4. Lanjutkan antrean.

    Konsol

    Untuk melanjutkan antrean menggunakan konsol Google Cloud:

    1. Buka halaman antrean Cloud Tasks di konsol.

      Buka halaman antrean Cloud Tasks

    2. Pilih nama antrean yang ingin Anda jeda, lalu klik Lanjutkan antrean.

    3. Konfirmasi tindakan.

    gcloud

    gcloud tasks queues resume QUEUE_ID

    Ganti QUEUE_ID dengan ID antrean Anda.

Mengonfigurasi pemilihan rute tingkat antrean untuk tugas App Engine

Untuk mengonfigurasi perutean tingkat antrean untuk tugas App Engine, tetapkan parameter appEngineRoutingOverride antrean ke layanan dan versi App Engine pilihan Anda.

Untuk menyiapkan pemilihan rute tingkat antrean non-default ini dan mengganti pemilihan rute tingkat tugas, Anda dapat menggunakan gcloud:

  gcloud tasks queues update QUEUE_ID\
      --routing-override=service:SERVICE,version:VERSION

Ganti kode berikut:

  • SERVICE: layanan pekerja App Engine yang bertanggung jawab untuk penanganan tugas.
  • VERSION: versi aplikasi.

Misalnya, jika Anda menyiapkan layanan pekerja SERVICE untuk menangani semua tugas dalam antrean, Anda dapat merutekan ke layanan tersebut dan versi default:

  gcloud tasks queues update QUEUE_ID \
      --routing-override=service:SERVICE

Jelaskan antrean:

    gcloud tasks queues describe QUEUE_ID --location=LOCATION

Ganti kode berikut:

  • QUEUE_ID: ID antrean (nama pendeknya)
  • LOCATION: lokasi antrean

Outputnya akan terlihat seperti ini:

appEngineRoutingOverride:
  host: SERVICE.PROJECT_ID.appspot.com
  service: SERVICE
name: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID
rateLimits:
  maxBurstSize: 100
  maxConcurrentDispatches: 1000
  maxDispatchesPerSecond: 500.0
retryConfig:
  maxAttempts: 100
  maxBackoff: 3600s
  maxDoublings: 16
  minBackoff: 0.100s
state: RUNNING

Menghapus pemilihan rute tingkat antrean untuk target App Engine

Saat pemilihan rute tingkat antrean dihapus, pemilihan rute tingkat tugas berlaku untuk tugas yang saat ini ada dalam antrean dan tugas yang ditambahkan ke antrean di masa mendatang. Untuk menghapus rute tingkat antrean, jalankan perintah berikut:

  gcloud tasks queues update QUEUE_ID \
      --clear-routing-override

Menentukan batas kapasitas

Anda dapat menetapkan kecepatan maksimum dan jumlah tugas serentak yang dapat dikirim oleh antrean.

  gcloud tasks queues update QUEUE_ID \
      --max-dispatches-per-second=DISPATCH_RATE \
      --max-concurrent-dispatches=MAX_RUNNING

Ganti kode berikut:

  • DISPATCH_RATE: kecepatan pengiriman (ini adalah kecepatan pembaruan token di bucket). Dalam kondisi saat ada alur tugas yang relatif stabil, ini adalah setara dengan kecepatan pengiriman tugas.
  • MAX_RUNNING: jumlah maksimum tugas dalam antrean yang dapat dijalankan sekaligus.

Misalnya, jika membuat antrean tanpa menetapkan parameter apa pun, Anda dapat memperbarui jumlah maksimum tugas serentak dengan memanggil:

  gcloud tasks queues update QUEUE_ID \
          --max-concurrent-dispatches=MAX_CONCURRENT_DISPATCHES

Describe antrean:

  gcloud tasks queues describe QUEUE_ID --location=LOCATION

Ganti kode berikut:

  • QUEUE_ID: ID antrean (nama pendeknya)
  • LOCATION: lokasi antrean

Outputnya akan berupa:

name: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID
rateLimits:
  maxBurstSize: 100
  maxConcurrentDispatches: MAX_CONCURRENT_DISPATCHES
  maxDispatchesPerSecond: 500.0
retryConfig:
  maxAttempts: 100
  maxBackoff: 3600s
  maxDoublings: 16
  minBackoff: 0.100s
state: RUNNING

Menentukan kecepatan pemrosesan menggunakan perintah gcloud versus menggunakan queue.yaml

Pendekatan Cloud Tasks API untuk menentukan kecepatan pemrosesan antrean sedikit berbeda dengan pendekatan yang dilakukan menggunakan upload file queue.yaml, meskipun kedua metode tersebut menghasilkan antrean yang menggunakan mekanisme dasar yang sama.

Dalam kedua kasus tersebut, antrean menggunakan algoritma token bucket untuk mengontrol laju eksekusi tugas. Setiap antrean bernama memiliki bucket yang menyimpan tokennya.

Setiap kali aplikasi Anda menjalankan sebuah tugas, token akan dihapus dari bucket. Antrean akan terus memproses tugas hingga bucketnya kehabisan token. Sistem mengisi ulang bucket dengan token baru secara terus-menerus berdasarkan tingkat max_dispatches_per_second yang Anda tentukan untuk antrean. Jika antrean Anda berisi tugas yang akan diproses, dan bucket antrean berisi token, sistem akan secara bersamaan memproses tugas sebanyak token yang ada, hingga nilai max_concurrent_dispatches yang telah Anda tetapkan.

Beban yang tidak merata dapat menyebabkan jumlah token dalam bucket meningkat secara signifikan, yang dapat menyebabkan lonjakan pemrosesan saat lonjakan permintaan masuk. Dalam hal ini, antrean Anda mungkin mengalami kecepatan pengiriman sebenarnya yang melebihi kecepatan max_dispatches_per_second, yang menghabiskan resource sistem dan bersaing dengan permintaan layanan pengguna. Jika Anda menggunakan antrean untuk mengelola kecepatan pengiriman berdasarkan SLA yang relatif lambat untuk layanan downstream, hal ini dapat menyebabkan error seperti HTTP 429 (Terlalu Banyak Permintaan) atau 503 (Layanan Tidak Tersedia).

Saat menggunakan metode Cloud Tasks API, Anda memiliki dua kolom untuk menentukan kecepatan pengiriman antrean:

  • max_dispatches_per_second
  • max_concurrent_dispatches

Kolom ketiga, max_burst_size, dihitung oleh sistem berdasarkan nilai yang Anda tetapkan untuk max_dispatches_per_second.

Saat menggunakan metode queue.yaml, Anda dapat menetapkan ketiga elemen:

  • max_concurrent_requests, yang setara dengan max_concurrent_dispatches
  • rate, yang setara dengan max_dispatches_per_second
  • bucket_size, yang setara dengan max_burst_size

Pada umumnya, menggunakan metode Cloud Tasks API dan membiarkan sistem menetapkan max_burst_size menghasilkan kecepatan yang sangat efisien untuk mengelola lonjakan permintaan. Namun, dalam beberapa kasus, terutama jika kecepatan yang diinginkan relatif lambat, baik menggunakan metode queue.yaml untuk menetapkan bucket_size secara manual ke nilai kecil, atau menetapkan max_concurrent_dispatches ke nilai kecil melalui Cloud Tasks API dapat memberi Anda kontrol lebih besar.

Menetapkan parameter percobaan ulang

Jika tugas tidak berhasil diselesaikan, Cloud Tasks akan mencoba ulang tugas tersebut dengan backoff eksponensial sesuai dengan parameter yang telah Anda tetapkan. Anda dapat menentukan jumlah maksimum percobaan ulang tugas yang gagal dalam antrean, menetapkan batas waktu untuk percobaan ulang, dan mengontrol interval antar-percobaan.

  gcloud tasks queues update QUEUE_ID \
      --max-attempts=MAX_ATTEMPTS \
      --min-backoff=MIN_INTERVAL \
      --max-backoff=MAX_INTERVAL \
      --max-doublings=MAX_DOUBLINGS \
      --max-retry-duration=MAX_RETRY_DURATION

Ganti kode berikut:

  • MAX_ATTEMPTS: jumlah maksimum percobaan untuk tugas, termasuk percobaan pertama. Anda dapat mengizinkan percobaan ulang tanpa batas dengan menetapkan tanda ini ke unlimited.
  • MIN_INTERVAL: jumlah waktu minimum yang harus ditunggu di antara upaya percobaan ulang. Nilai harus berupa string yang diakhiri dengan "s", seperti 5s.
  • MAX_INTERVAL: jumlah maksimum waktu tunggu antara upaya percobaan ulang. Nilai harus berupa string yang diakhiri dengan "s", seperti 5s.
  • MAX_DOUBLINGS: frekuensi maksimum untuk penggandaan interval antar-percobaan ulang tugas yang gagal sebelum peningkatan menjadi konstan.
  • MAX_RETRY_DURATION: jumlah maksimum waktu untuk mencoba kembali tugas yang gagal, diukur dari saat tugas pertama kali dicoba. Nilainya harus berupa string yang diakhiri dengan "s", seperti 5s.

Pastikan antrean Anda berhasil dikonfigurasi:

    gcloud tasks queues describe QUEUE_ID --location=LOCATION

Ganti kode berikut:

  • QUEUE_ID: ID antrean (nama pendeknya)
  • LOCATION: lokasi antrean

Langkah selanjutnya