Membuat antrean Cloud Tasks

Halaman ini menjelaskan cara membuat antrean Cloud Tasks. Saat tugas ditambahkan ke antrean, antrean akan mengirimkannya dan memastikan tugas 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.

  Catatan: Dua lokasi, yang disebut europe-west dan us-central dalam perintah App Engine, masing-masing disebut europe-west1 dan us-central1 dalam perintah Cloud Tasks.

• 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

Catatan: Jika Anda mengonfigurasi pemilihan rute untuk antrean App Engine dan tidak menetapkan layanan target yang berisi worker yang sesuai secara eksplisit, layanan default akan digunakan. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi antrean Cloud Tasks.

Konsol

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

   Buka Queues

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 frekuensi, 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:

• PROJECT_ID: Project ID Google Cloud Anda.
• 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).

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

Properti lain yang dapat dikonfigurasi untuk Queue resource mencakup batas frekuensi, 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:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json. Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:

cat > request.json << 'EOF'
{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}
EOF

Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json. Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:

@'
{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}
'@  | Out-File -FilePath request.json -Encoding utf8

Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues" | Select-Object -Expand Content

APIs Explorer (browser)

Salin isi permintaan dan buka halaman referensi metode. Panel APIs Explorer terbuka di sisi kanan halaman. Anda bisa berinteraksi dengan alat ini untuk mengirim permintaan. Tempelkan isi permintaan di alat ini, lengkapi kolom lainnya yang wajib diisi, lalu klik Execute.

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 hingga 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 Queues

   Tanda centang hijau 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 projects.locations.queues.get metode.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: Project ID Google Cloud Anda.
• LOCATION: region tempat antrean di-deploy—misalnya, us-central1.
• QUEUE_ID: ID singkat antrean—misalnya, my-queue.

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID" | Select-Object -Expand Content

APIs Explorer (browser)

Buka halaman referensi metode. Panel APIs Explorer terbuka di sisi kanan halaman. Anda bisa berinteraksi dengan alat ini untuk mengirim permintaan. Lengkapi kolom yang wajib diisi, lalu klik Execute.

Jika berhasil, isi respons berisi 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"
}

Memecahkan masalah saat membuat antrean

Catatan: Logging untuk antrean Anda tidak diaktifkan secara default. Untuk mengetahui informasi tentang cara mengaktifkan logging, lihat Menggunakan Cloud Logging dengan antrean.

Jika tidak melihat output yang diharapkan, Anda dapat mencoba langkah berikut:

• Tunggu setidaknya satu menit agar antrean diinisialisasi.

• Pastikan antrean dengan ID yang sama belum ada. Anda dapat melihat antrean di project menggunakan gcloud tasks queues list perintah:

  gcloud tasks queues list \
      --location=LOCATION

  Untuk menelusuri beberapa lokasi, Anda harus membuat beberapa permintaan.

• Periksa apakah Anda telah mencapai kuota antrean kuota:

  1. Di Google Cloud konsol, buka halaman API/Service Details untuk Cloud Tasks API.

     Buka API/Service Details

  2. Klik tab Quotas &System limits.

  3. Untuk menambah kuota, di baris untuk kuota, klik ikon elipsis > Edit quota.

     Untuk mengetahui informasi selengkapnya, lihat Meminta penyesuaian kuota.

• Jalankan kembali perintah untuk membuat antrean dan pastikan setiap langkah diselesaikan dengan benar.

Langkah berikutnya

• Mengonfigurasi antrean Cloud Tasks
• Membuat tugas Cloud Tasks
• Menetapkan parameter percobaan ulang untuk tugas
• Mengelola antrean dan tugas