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 file yang dapat dieksekusi tugas, karena file yang dapat dieksekusi harus dimuat ke memori
• Mengalokasikan memori dalam proses pekerjaan 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, memori yang dialokasikan untuk setiap tugas adalah , dan memori yang dialokasikan untuk fungsi adalah 256 MiB.

Memori yang diperlukan saat menyetel nilai CPU

Saat menetapkan nilai CPU, diperlukan memori berikut:

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 Anda dipengaruhi oleh konfigurasi memori dan durasi resource Anda aktif, serta faktor lainnya. Menyediakan resource secara berlebihan dapat meningkatkan biaya Anda. Untuk menentukan konfigurasi memori mana yang paling cocok untuk resource Anda:

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

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 Anda untuk mencegah kebocoran memori dan menggunakan lebih sedikit memori. Lihat dasbor Cloud Monitoring untuk lebih memahami pemanfaatan memori Anda.

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

Peran yang diperlukan

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

• Cloud Run Developer (roles/run.developer) di 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 Google Cloud konsol, 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 Lihat dan edit konfigurasi tugas.

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

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

5. Klik Buat atau Perbarui.

gcloud

• Untuk menetapkan batas memori saat 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 memperbarui 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 di 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: Google Cloud region. 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 Detail tugas.

3. Klik Lihat dan edit konfigurasi tugas.

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.