Membuat antrean Cloud Tasks

Halaman ini menjelaskan cara membuat antrean Cloud Tasks. Saat tugas ditambahkan ke antrean, antrean akan mengirimkannya dan memastikan tugas tersebut diproses dengan andal oleh layanan, yang juga dikenal sebagai worker.

Perhatikan hal berikut:

  • Nama antrean terdiri dari tiga bagian: project ID, lokasi, dan ID antrean. Anda harus memiliki Google Cloud project yang menyediakan project ID.

  • Jika menggunakan tugas target App Engine, Anda juga harus memiliki an aplikasi App Engine yang berlokasi di region tertentu dan tempat antrean serta pengendali Anda berjalan. Perhatikan region saat Anda menambahkan aplikasi.

  • Menggunakan tugas target HTTP tidak memerlukan aplikasi App Engine. Anda memilih a Google Cloud lokasi saat membuat antrean.

Membuat antrean

Anda dapat membuat antrean dengan cara berikut:

  • Di Google Cloud konsol
  • Dengan menggunakan Google Cloud CLI di terminal atau Cloud Shell
  • Dengan mengirim permintaan langsung ke Cloud Tasks API

Konsol

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

    Buka Antrean

  2. Klik Create queue.

  3. Masukkan Queue name—misalnya, my-queue.

  4. Dalam daftar Region, pilih lokasi yang didukung tempat antrean akan berjalan—misalnya, asia-south1.

    Jika organisasi Anda membatasi lokasi resource dan Anda ingin membuat antrean di us-central1 atau us-central2, kebijakan organisasi harus mengizinkan pembuatan antrean di us-central1 dan us-central2 (meskipun Anda hanya memerlukan antrean di salah satu region tersebut).

  5. Secara opsional, Anda dapat mengonfigurasi antrean lebih lanjut Anda.

  6. Klik Create.

gcloud

Gunakan gcloud tasks queues create perintah untuk membuat antrean:

  gcloud tasks queues create QUEUE_ID \
      --location=LOCATION

Ganti kode berikut:

  • QUEUE_ID: ID yang Anda tetapkan ke antrean—misalnya, my-queue.

  • LOCATION: region yang didukung tempat antrean akan berjalan—misalnya, asia-south1.

    Jika organisasi Anda membatasi lokasi resource dan Anda ingin membuat antrean di us-central1 atau us-central2, kebijakan organisasi harus mengizinkan pembuatan antrean di us-central1 dan us-central2 (meskipun Anda hanya memerlukan antrean di salah satu region tersebut).

Flag lain untuk perintah gcloud CLI memungkinkan Anda mengonfigurasi batas kapasitas, opsi percobaan ulang, jenis antrean, dan lainnya.

REST API

Untuk membuat antrean, gunakan projects.locations.queues.create metode.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

Properti lain yang dapat dikonfigurasi untuk Queue resource mencakup batas kapasitas, opsi percobaan ulang, jenis antrean, dan lainnya.

Meminta isi JSON: 

{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Jika berhasil, isi respons memuat instance yang baru dibuat dari 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"
}

Antrean yang baru dibuat mungkin memerlukan waktu beberapa menit agar tersedia.

Mendeskripsikan antrean

Anda dapat mengonfirmasi bahwa antrean berhasil dibuat dengan cara berikut:

  • Di Google Cloud konsol
  • Dengan menggunakan gcloud CLI di terminal atau Cloud Shell

  • Dengan mengirim permintaan langsung ke Cloud Tasks API

Konsol

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

    Buka Antrean

    Tanda centang hijau akan menunjukkan bahwa antrean Anda berjalan.

  2. Untuk mengetahui detail selengkapnya, klik nama antrean, lalu klik tab Configuration.

gcloud

Gunakan gcloud tasks queues describe perintah untuk memverifikasi bahwa antrean berhasil dibuat:

gcloud tasks queues describe QUEUE_ID \
    --location=LOCATION

Ganti kode berikut:

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

Outputnya akan mirip dengan berikut ini:

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

REST API

Untuk mengambil antrean, gunakan