Menambahkan tugas App Engine ke antrean Cloud Tasks

Panduan memulai ini menunjukkan cara menambahkan tugas App Engine ke antrean Cloud Tasks menggunakan Cloud Tasks API.

Sebelum memulai

  1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

  2. Instal Google Cloud CLI.

  3. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

  4. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut: 

    gcloud init

  5. Buat atau pilih Google Cloud project.

    Peran yang diperlukan untuk memilih atau membuat project

    • Pilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project mana pun yang telah diberi peran.
    • Membuat project: Untuk membuat project, Anda memerlukan peran Pembuat Project (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

    • Buat Google Cloud project:

      gcloud projects create PROJECT_ID

      Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

    • Pilih project Google Cloud yang Anda buat:

      gcloud config set project PROJECT_ID

      Ganti PROJECT_ID dengan nama project Google Cloud Anda.

  6. Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

  7. Aktifkan Cloud Resource Manager dan Cloud Tasks API:

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran. 

    gcloud services enable cloudresourcemanager.googleapis.com tasks.googleapis.com

  8. Jika Anda menggunakan shell lokal, buat kredensial autentikasi lokal untuk akun pengguna Anda: 

    gcloud auth application-default login

    Anda tidak perlu melakukan langkah ini jika menggunakan Cloud Shell.

    Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, konfirmasi bahwa Anda telah login ke gcloud CLI dengan identitas gabungan Anda.

  9. Instal Google Cloud CLI.

  10. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

  11. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut: 

    gcloud init

  12. Buat atau pilih Google Cloud project.

    Peran yang diperlukan untuk memilih atau membuat project

    • Pilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project mana pun yang telah diberi peran.
    • Membuat project: Untuk membuat project, Anda memerlukan peran Pembuat Project (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

    • Buat Google Cloud project:

      gcloud projects create PROJECT_ID

      Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

    • Pilih project Google Cloud yang Anda buat:

      gcloud config set project PROJECT_ID

      Ganti PROJECT_ID dengan nama project Google Cloud Anda.

  13. Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

  14. Aktifkan Cloud Resource Manager dan Cloud Tasks API:

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran. 

    gcloud services enable cloudresourcemanager.googleapis.com tasks.googleapis.com

  15. Jika Anda menggunakan shell lokal, buat kredensial autentikasi lokal untuk akun pengguna Anda: 

    gcloud auth application-default login

    Anda tidak perlu melakukan langkah ini jika menggunakan Cloud Shell.

    Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, konfirmasi bahwa Anda telah login ke gcloud CLI dengan identitas gabungan Anda.

  16. Akun layanan default App Engine dibuat secara otomatis saat Anda menggunakan App Engine. Anda dapat menggunakan akun layanan ini saat mencoba panduan memulai cepat ini. Namun, bergantung pada konfigurasi kebijakan organisasi Anda, akun layanan default mungkin tidak otomatis diberi peran Editor di project Anda. Jika demikian, Anda harus memberikan peran berikut kepada akun layanan:
    1. Administrator Artifact Registry (roles/artifactregistry.admin)
    2. Penulis Create-on-Push Artifact Registry (roles/artifactregistry.createOnPushWriter)
    3. Compute Admin (roles/compute.admin)
    4. Logs Writer (roles/logging.logWriter)
    5. Storage Object Viewer (roles/storage.objectViewer)

Menambahkan aplikasi App Engine

Saat menargetkan tugas App Engine, dan sebelum dapat men-deploy aplikasi ke lingkungan standar App Engine, Anda harus menambahkan aplikasi App Engine ke project Anda.

  1. Di konsol Google Cloud , buka halaman App Engine.

    Buka App Engine

  2. Pada dialog Welcome to App Engine, lakukan salah satu hal berikut:

    • Jika Anda telah membuat aplikasi App Engine dan ada pesan Your App Engine application has been created yang ditampilkan, Anda dapat melewati langkah-langkah yang tersisa di bagian ini dan melanjutkan dengan langkah-langkah di bagian Menginstal dan men-deploy contoh.

      atau

    • Jika Anda belum membuat aplikasi App Engine, klik Create application dan lanjutkan dengan langkah-langkah yang tersisa di bagian ini.

  3. Pilih region untuk aplikasi Anda dan catat region tersebut.

    Perhatikan bahwa europe-west dan us-central masing-masing dipanggil sebagai europe-west1 dan us-central1 dalam perintah Cloud Tasks.

  4. Jangan memilih akun layanan; akun layanan App Engine default akan digunakan.

  5. Klik Berikutnya.

    Aplikasi dikonfigurasi dan dibuat. Proses ini dapat membutuhkan waktu beberapa menit.

  6. Jangan download Cloud SDK; sebagai gantinya, klik Saya akan melakukannya nanti.

    Anda akan melihat pesan Aplikasi App Engine Anda telah dibuat.

Menginstal dan men-deploy contoh

Contoh Node.js yang digunakan dalam panduan memulai ini terdiri dari dua file: createTask.js dijalankan secara lokal sebagai alat command line untuk membuat dan menambahkan tugas ke antrean Tasks; server.js di-deploy di App Engine sebagai layanan pekerja untuk memproses tugas.

  1. Di terminal, clone repositori aplikasi contoh ke komputer lokal Anda.

    git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git

  2. Buka direktori yang berisi kode contoh.

    cd nodejs-docs-samples/cloud-tasks/snippets

  3. Instal semua dependensi menggunakan pengelola paket Node.js.

    Anda dapat menggunakan NPM:

    npm install

    Atau, Anda dapat menggunakan Yarn:

    yarn install

  4. Deploy layanan pekerja (server.js) ke lingkungan standar App Engine.

    gcloud app deploy app.yaml

  5. Pastikan aplikasi yang berisi layanan sedang berjalan.

    gcloud app browse

  6. Di browser, buka link yang diberikan. Contoh:

    https://PROJECT_ID.uc.r.appspot.com/

    Anda akan melihat Hello, World! ditampilkan.

Membuat antrean Cloud Tasks

Gunakan perintah gcloud tasks queues create untuk membuat antrean di lingkungan yang telah Anda siapkan.

  1. Di terminal, buat antrean yang mencatat semua operasi.

    gcloud tasks queues create QUEUE_NAME \
    --log-sampling-ratio=1.0 \
    --location=REGION

    Ganti kode berikut:

    • QUEUE_NAME: nama untuk antrean Cloud Tasks Anda
    • REGION: region tempat Anda men-deploy aplikasi

  2. Tunggu hingga antrean diinisialisasi, lalu verifikasi bahwa antrean berhasil dibuat.

    gcloud tasks queues describe QUEUE_NAME \
    --location=REGION

    Outputnya akan mirip dengan berikut ini:

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

Menambahkan tugas ke antrean Cloud Tasks

Buat tugas, tambahkan ke antrean yang Anda buat, dan kirimkan tugas tersebut ke layanan worker.

  1. Tetapkan variabel lingkungan berikut. Klien menggunakan informasi ini untuk membuat permintaan.

    export PROJECT_ID=PROJECT_ID
export LOCATION_ID=REGION
export QUEUE_ID=QUEUE_NAME

  2. Buat tugas dengan payload hello dan tambahkan tugas tersebut ke antrean Anda. Payload dapat berupa data apa pun dari permintaan yang diperlukan layanan pekerja untuk memproses tugas.

    node createTask.js $PROJECT_ID $QUEUE_ID $LOCATION_ID hello

  3. Pastikan tugas telah dijalankan dengan menampilkan log layanan worker.

    gcloud app logs read

    Log akan terlihat seperti berikut:

    2024-06-20 15:00:00 default[20240620t143852]  "POST /log_payload HTTP/1.1" 200
2024-06-20 15:00:00 default[20240620t143852]  App listening on port 8081
2024-06-20 15:00:00 default[20240620t143852]  Press Ctrl+C to quit.
2024-06-20 15:00:00 default[20240620t143852]  Received task with payload: hello

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, hapus project Google Cloud yang berisi resource tersebut.

Menghapus Google Cloud project:

gcloud projects delete PROJECT_ID

Atau, Anda dapat menghapus resource yang Anda buat:

  1. Hapus antrean Cloud Tasks:

    gcloud tasks queues delete QUEUE_NAME \
    --location=REGION

  2. Nonaktifkan aplikasi App Engine.

Langkah berikutnya