Mengonfigurasi batas memori untuk instance

Anda dapat memilih jumlah memori yang akan disediakan untuk instance Cloud Run. Halaman ini menjelaskan cara menentukan jumlah memori yang tersedia untuk instance 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 instance, karena file yang dapat dieksekusi harus dimuat ke memori
  • Mengalokasikan memori dalam proses instance 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 instance Cloud Run. Secara default, memori yang dialokasikan ke setiap instance adalah 2 GiB .

Memori yang diperlukan saat menetapkan nilai CPU

Saat menetapkan nilai CPU, memori berikut diperlukan:

CPU Memori yang diperlukan
1 vCPU 512 MiB hingga 4 GiB
2 vCPU 512 MiB hingga 8 GiB
4 vCPU 2 hingga 16 GiB
6 vCPU 4 hingga 24 GiB
8 vCPU 4 hingga 32 GiB

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.

Pertimbangan biaya

Biaya instance Cloud Run Anda dipengaruhi oleh konfigurasi memorinya dan durasi resource Anda aktif, serta faktor lainnya. Menyediakan resource secara berlebihan dapat meningkatkan biaya Anda. Untuk menentukan konfigurasi memori mana yang mungkin paling cocok untuk resource Anda:

  1. Tetapkan konfigurasi dasar awal.
  2. Pantau metrik penggunaan memori Anda di Cloud Monitoring saat menguji sistem di bawah beban.
  3. Sesuaikan konfigurasi Anda sesuai kebutuhan.

Jika penggunaan memori secara konsisten rendah, pertimbangkan untuk mengurangi memori yang dialokasikan. Jika latensi tinggi dan penggunaan memori mendekati 100%, pertimbangkan untuk meningkatkan memori yang dialokasikan. Jika Anda mengalami error Kehabisan Memori (OOM), Anda harus meningkatkan memori yang dialokasikan atau mengubah aplikasi untuk mencegah kebocoran memori dan menggunakan lebih sedikit memori. Lihat dasbor Cloud Monitoring untuk lebih memahami penggunaan memori Anda.

Tinjau harga Cloud Run atau perkirakan biaya dengan kalkulator harga untuk mengetahui informasi selengkapnya.

Peran yang diperlukan

Guna mendapatkan izin yang Anda perlukan untuk mengonfigurasi dan men-deploy instance 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 instance 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 instance Cloud Run menggunakan Google Cloud CLI atau YAML:

gcloud

Anda dapat memperbarui alokasi memori untuk instance tertentu menggunakan perintah berikut:

gcloud beta run instances update INSTANCE --memory SIZE

Ganti kode berikut:

  • INSTANCE: nama instance Anda
  • SIZE: 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 instances deploy --image IMAGE_URL --memory SIZE

Ganti kode berikut:

  • IMAGE_URL: referensi ke image container, seperti us-docker.pkg.dev/cloudrun/container/hello:latest.
  • SIZE: 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.

YAML

  1. Jika Anda membuat instance baru, lewati langkah ini. Jika Anda memperbarui instance yang ada, download konfigurasi YAML-nya:

    gcloud beta run instances describe INSTANCE --format export > instance.yaml

  2. Contoh berikut berisi konfigurasi YAML:

    apiVersion: run.googleapis.com/v1
kind: Instance
metadata:
  name: INSTANCE
  annotations:
    run.googleapis.com/launch-stage: BETA
spec:
  containers:
  - image: IMAGE_URL
    resources:
      limits:
        memory: SIZE

    Ganti kode berikut:

    • INSTANCE: nama instance Cloud Run Anda.
    • IMAGE_URL: referensi ke image container, seperti us-docker.pkg.dev/cloudrun/container/hello:latest.
    • SIZE: ukuran memori yang dipilih. Formatnya yaitu bilangan 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.

  3. Buat atau perbarui instance menggunakan perintah berikut:

    gcloud beta run instances replace instance.yaml