Mengonfigurasi batas memori untuk kumpulan pekerja

Anda dapat memilih jumlah memori yang akan disediakan untuk kumpulan pekerja Cloud Run. Halaman ini menjelaskan cara menentukan jumlah memori yang tersedia untuk kumpulan pekerja Anda.

Memahami penggunaan memori

Instance Cloud Run yang melebihi batas memori yang diizinkan akan dihentikan.

Memori yang tersedia untuk instance Anda harus cukup untuk:

  • Menjalankan file yang dapat dieksekusi dari kumpulan pekerja, karena file yang dapat dieksekusi harus dimuat ke memori
  • Mengalokasikan memori dalam proses worker pool Anda
  • Menulis file ke sistem file

Ukuran image container yang di-deploy tidak memengaruhi memori yang tersedia untuk instance.

Menetapkan dan memperbarui batas memori

Anda dapat menetapkan batas memori pada kumpulan worker Cloud Run. Secara default, memori yang dialokasikan untuk setiap kumpulan pekerja adalah 512 MiB.

CPU minimum yang diperlukan

Jumlah memori yang dialokasikan yang Anda pilih sesuai dengan jumlah CPU minimum untuk kumpulan pekerja Anda. Saat mengatur batas memori, diperlukan batas CPU minimum sebagai berikut:

Memori CPU minimum yang diperlukan
2 GiB 1 vCPU
Lebih dari 4 GiB 2 vCPU
Lebih dari 8 GiB 4 vCPU
Lebih dari 16 GiB 6 vCPU
Lebih dari 24 GiB 8 vCPU

Jumlah memori maksimum

Jumlah maksimum memori yang dapat Anda konfigurasi adalah 32 gibibyte (32 Gi).

Anda dapat menerapkan batas memori maksimum menggunakan kebijakan organisasi kustom.

Memori minimum

Setelan memori minimum adalah 512 MiB.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengonfigurasi dan men-deploy kumpulan pekerja Cloud Run, minta administrator Anda untuk memberi Anda peran IAM berikut:

Untuk mengetahui daftar peran dan izin IAM yang terkait dengan Cloud Run, lihat Peran IAM Cloud Run dan Izin IAM Cloud Run. Jika kumpulan pekerja Cloud Run Anda berinteraksi dengan Google Cloud API, seperti Library Klien Cloud, lihat panduan konfigurasi identitas layanan. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat izin deployment dan mengelola akses.

Mengonfigurasi batas memori

Setiap perubahan konfigurasi akan menghasilkan revisi baru. Revisi selanjutnya juga akan otomatis mendapatkan setelan konfigurasi ini, kecuali jika Anda melakukan pembaruan eksplisit untuk mengubahnya.

Anda dapat menetapkan batas memori untuk kumpulan pekerja Cloud Run menggunakan Google Cloud CLI atau Terraform:

gcloud

Anda dapat memperbarui alokasi memori untuk kumpulan pekerja tertentu menggunakan perintah berikut:

gcloud beta run worker-pools update WORKER_POOL --memory SIZE

Ganti:

  • WORKER_POOL dengan nama kumpulan pekerja Anda
  • SIZE dengan ukuran memori dari tabel CPU dan memori. Format untuk ukuran adalah angka tetap atau floating point yang diikuti dengan satuan: G atau M yang sesuai dengan gigabyte atau megabyte, atau menggunakan pangkat dua yang setara Gi atau Mi yang sesuai dengan gibibyte atau mebibyte.

Anda juga dapat menetapkan batas memori selama deployment menggunakan perintah:

gcloud beta run worker-pools deploy --image IMAGE_URL --memory SIZE

Ganti:

  • IMAGE_URL dengan referensi ke image container yang berisi worker pool, seperti us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
  • SIZE dengan ukuran memori dari tabel CPU dan memori. Format untuk ukuran adalah angka tetap atau floating point yang diikuti dengan satuan: G atau M yang sesuai dengan gigabyte atau megabyte, atau gunakan pangkat dua yang setara: Gi atau Mi yang sesuai dengan gibibyte atau mebibyte.

Terraform

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"
  launch_stage = "BETA"

  template {
    containers {
      image = "IMAGE_URL"
      resources {
        limits = {
          memory = "SIZE"
        }
      }
    }
  }
}

Ganti:

  • WORKER_POOL dengan nama kumpulan pekerja.
  • REGION dengan region Google Cloud . Misalnya, europe-west1.
  • IMAGE_URL dengan referensi ke image container yang berisi worker pool, seperti us-docker.pkg.dev/cloudrun/container/worker-pool:latest
  • SIZE dengan ukuran memori dari tabel CPU dan memori. Format untuk ukuran adalah angka tetap atau floating point yang diikuti dengan satuan: G atau M yang sesuai dengan gigabyte atau megabyte, atau menggunakan pangkat dua yang setara Gi atau Mi yang sesuai dengan gibibyte atau mebibyte.

Melihat konfigurasi memori untuk kumpulan pekerja

  1. Di konsol Google Cloud , buka Cloud Run:

    Buka Cloud Run

  2. Klik Worker pools untuk menampilkan daftar worker pool yang di-deploy.

  3. Klik kumpulan pekerja yang ingin Anda periksa untuk menampilkan panel detailnya.

  4. Klik tab Containers untuk menampilkan konfigurasi memori kumpulan pekerja untuk setiap container.