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 pekerja.
Perhatikan hal-hal berikut:
Nama antrean terdiri dari tiga bagian: project ID, lokasi, dan ID antrean. Anda harus memiliki project Google Cloud yang menyediakan project ID.
Jika menggunakan tugas target App Engine, Anda juga harus memiliki aplikasi App Engine yang terletak di region tertentu dan merupakan tempat antrean dan pengendali Anda berjalan. Perhatikan wilayah saat Anda menambahkan aplikasi.
Menggunakan tugas Target HTTP tidak memerlukan aplikasi App Engine. Anda memilih lokasi Google Cloud saat membuat antrean.
Membuat antrean
Anda dapat membuat antrean dengan cara berikut:
- Di konsol Google Cloud
- Dengan menggunakan Google Cloud CLI di terminal atau Cloud Shell
- Dengan mengirimkan permintaan langsung ke Cloud Tasks API
Di konsol Google Cloud, buka halaman Cloud Tasks > Antrean.
Klik
Buat antrean.Masukkan Nama antrean—misalnya,
my-queue
.Di 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
atauus-central2
, kebijakan organisasi harus mengizinkan pembuatan antrean dius-central1
danus-central2
(meskipun Anda hanya memerlukan antrean di salah satu region tersebut).Secara opsional, Anda dapat mengonfigurasi antrean lebih lanjut.
Klik Create.
Gunakan perintah gcloud tasks queues create
untuk membuat antrean:
gcloud tasks queues createQUEUE_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
atauus-central2
, kebijakan organisasi harus mengizinkan pembuatan antrean dius-central1
danus-central2
(meskipun Anda hanya memerlukan antrean di salah satu region tersebut).
Flag lain untuk perintah gcloud CLI memungkinkan Anda mengonfigurasi batas kecepatan, opsi percobaan ulang, jenis antrean, dan lainnya.
Untuk membuat antrean, gunakan metode
projects.locations.queues.create
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
: Project ID Google Cloud Anda.PROJECT_ID
: Region yang didukung tempat antrean akan berjalan—misalnya,LOCATION asia-south1
.Jika organisasi Anda membatasi lokasi resource dan Anda ingin membuat antrean di
us-central1
atauus-central2
, kebijakan organisasi harus mengizinkan pembuatan antrean dius-central1
danus-central2
(meskipun Anda hanya memerlukan antrean di salah satu region tersebut).
: ID yang Anda tetapkan ke antrean—misalnya,QUEUE_ID my-queue
.
Queue
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:
curl (Linux, macOS, atau Cloud Shell)
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)
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
API Explorer (browser)
Salin isi permintaan dan buka halaman referensi metode. Panel API 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 Jalankan.
Jika berhasil, isi respons akan memuat instance Queue
yang baru dibuat:
{ "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" }
Perlu waktu beberapa menit hingga antrean yang baru dibuat tersedia.
Deskripsikan antrean Anda
Anda dapat mengonfirmasi bahwa antrean berhasil dibuat dengan cara berikut:
- Di konsol Google Cloud
- Dengan menggunakan gcloud CLI di terminal atau Cloud Shell
Dengan mengirimkan permintaan langsung ke Cloud Tasks API
Di konsol Google Cloud, buka halaman Cloud Tasks > Antrean.
Tanda centang hijau
akan menunjukkan bahwa antrean Anda sedang berjalan.Untuk detail selengkapnya, klik nama antrean, lalu klik tab Konfigurasi.
Gunakan perintah gcloud tasks queues describe
untuk memverifikasi bahwa antrean Anda berhasil dibuat:
gcloud tasks queues describeQUEUE_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
Untuk mengambil antrean, gunakan metode
projects.locations.queues.get
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
: Project ID Google Cloud Anda.PROJECT_ID
: Region tempat antrean di-deploy—misalnya,LOCATION us-central1
.
: ID singkat antrean—misalnya,QUEUE_ID my-queue
.
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
curl (Linux, macOS, atau Cloud Shell)
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)
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
API Explorer (browser)
Buka halaman referensi metode. Panel API Explorer terbuka di sisi kanan halaman. Anda bisa berinteraksi dengan alat ini untuk mengirim permintaan. Lengkapi kolom yang wajib diisi, lalu klik Jalankan.
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 pembuatan 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 perintah
gcloud tasks queues list
:gcloud tasks queues list \ --location=
LOCATION Untuk menelusuri beberapa lokasi, Anda perlu membuat beberapa permintaan.
Periksa apakah Anda telah mencapai kuota antrean:
Di konsol Google Cloud, buka halaman API/Service Details untuk Cloud Tasks API .
Klik tab Quotas & System limits.
Untuk menaikkan kuota, di baris untuk kuota, klik ikon elipsis > Edit kuota.
Untuk mengetahui informasi selengkapnya, lihat Meminta nilai kuota yang lebih tinggi.
Jalankan kembali perintah untuk membuat antrean dan pastikan setiap langkah selesai dengan benar.