Mengonfigurasi batas memori untuk tugas

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

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).

Memori minimum

Setelan memori minimum adalah 512 MiB.

Pertimbangan biaya

Biaya tugas Cloud Run dipengaruhi oleh konfigurasi memori dan durasi aktif resource Anda, di antara faktor lainnya. Penyediaan resource yang berlebihan dapat meningkatkan biaya Anda. Untuk menentukan konfigurasi memori yang mungkin paling sesuai untuk resource Anda:

1. Menetapkan konfigurasi dasar pengukuran awal.
2. Pantau metrik penggunaan memori Anda di Cloud Monitoring saat menguji sistem yang sedang dimuat.
3. Sesuaikan konfigurasi Anda jika diperlukan.

Jika penggunaan memori selalu 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

Untuk mendapatkan izin yang Anda perlukan untuk mengonfigurasi tugas Cloud Run, minta administrator untuk memberi Anda peran IAM berikut:

• Cloud Run Developer (roles/run.developer) pada tugas Cloud Run
• Pengguna Akun Layanan (roles/iam.serviceAccountUser) pada identitas layanan

Untuk mengetahui daftar peran dan izin IAM yang terkait dengan Cloud Run, lihat Peran IAM Cloud Run dan Izin IAM Cloud Run. Jika tugas 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

Anda harus menentukan nilai minimum 512Mi untuk tugas Cloud Run.

Anda dapat mengonfigurasi batas memori untuk tugas Cloud Run menggunakan konsolGoogle Cloud , gcloud CLI, YAML, atau Terraform:

Konsol

1. Di konsol Google Cloud , buka halaman Cloud Run:

   Buka Cloud Run

2. Pilih Jobs dari menu navigasi Cloud Run:

   1. Jika Anda membuat tugas baru, klik Deploy container untuk mengisi halaman setelan tugas awal.

   2. Jika Anda mengonfigurasi tugas yang ada, pilih tugas, lalu klik View and edit job configuration.

3. Klik Containers, Connections, Security untuk meluaskan halaman properti tugas.

4. Di tab Containers, pilih ukuran memori dari daftar Memory.

5. Klik Buat atau Perbarui.

gcloud

• Untuk menetapkan batas memori saat Anda membuat tugas baru, jalankan perintah berikut:

  gcloud run jobs create JOB --image IMAGE_URL --memory SIZE

  Ganti kode berikut:

  • JOB: nama tugas Cloud Run Anda.
  • IMAGE_URL: referensi ke image container—misalnya, us-docker.pkg.dev/cloudrun/container/job:latest.
  • SIZE: ukuran 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.

• Untuk menetapkan batas memori saat Anda memperbarui tugas yang ada, jalankan perintah berikut:

  gcloud run jobs update JOB --memory SIZE

YAML

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

   gcloud run jobs describe JOB --format export > job.yaml

2. Perbarui atribut memory:

   apiVersion: run.googleapis.com/v1
   kind: Job
   metadata:
     name: JOB
   spec:
     template:
       spec:
         template:
           spec:
             containers:
             - image: IMAGE_URL
               resources:
                 limits:
                   memory: SIZE

   Ganti kode berikut:

   • JOB: nama tugas Cloud Run Anda.
   • IMAGE_URL: referensi ke image container—misalnya, us-docker.pkg.dev/cloudrun/container/job:latest.
   • SIZE: ukuran memori, dengan menentukan minimum 512Mi. 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.

   Anda juga dapat menentukan konfigurasi lainnya, seperti variabel lingkungan atau batas memori.

3. Buat atau perbarui tugas menggunakan perintah berikut:

   gcloud run jobs replace job.yaml

   Perintah gcloud run jobs replace secara default menggunakan file job.yaml jika ada.

Terraform

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

Tambahkan kode berikut ke resource google_cloud_run_v2_job dalam konfigurasi Terraform Anda:

resource "google_cloud_run_v2_job" "default" {
  name     = "JOB"
  location = "REGION"
  deletion_protection = false

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job"
        resources {
          limits = {
            cpu    = "2"
            memory = "SIZE"
          }
        }
      }
    }
  }
}

Ganti kode berikut:

• JOB: nama tugas Cloud Run Anda.
• REGION: region Google Cloud . Contohnya, europe-west1.
• SIZE: ukuran memori yang diperlukan, dengan menentukan minimum 512Mi. 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.

Lihat setelan batas memori

Untuk melihat setelan batas memori saat ini pada tugas Cloud Run Anda, gunakan konsol Google Cloud atau Google Cloud CLI:

Konsol

1. Di konsol Google Cloud , buka halaman tugas Cloud Run:

   Buka tugas Cloud Run

2. Klik tugas untuk membuka halaman Job details.

3. Klik View and edit job configuration.

4. Temukan setelan batas memori dalam detail konfigurasi.

gcloud

1. Jalankan perintah berikut:

   gcloud run jobs describe JOB

2. Temukan setelan batas memori dalam konfigurasi yang ditampilkan.