Mengonfigurasi batas memori

Anda dapat menyediakan tugas Cloud Run dengan jumlah memori yang berbeda. 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.

Berikut hal-hal yang termasuk dalam memori yang tersedia untuk instance Anda:

  • Menjalankan file yang dapat dieksekusi tugas, 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 termasuk dalam memori yang tersedia.

Menetapkan dan memperbarui batas memori

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

CPU minimum yang diperlukan

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

Memori CPU minimum yang diperlukan
128 MiB .083 vCPU
256 MiB .167 vCPU
512 MiB .333 vCPU
1 GiB .583 vCPU
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).

Memori minimum

Jumlah minimum memori yang dapat Anda konfigurasi di lingkungan eksekusi generasi kedua adalah 512 MiB.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mengonfigurasi tugas 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 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. Untuk menentukan memori untuk tugas Cloud Run:

Konsol

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

    Buka Cloud Run

  2. Klik Deploy container dan pilih Job untuk mengisi halaman setelan tugas awal. Jika Anda mengonfigurasi tugas yang sudah ada, pilih tugas, lalu klik Edit.

  3. Klik Container, variabel dan secret, koneksi, keamanan untuk memperluas halaman properti tugas.

  4. Klik tab Container.

    gambar

    • Pilih ukuran memori yang diinginkan dari menu drop-down Memory.
  5. Klik Buat atau Perbarui.

gcloud

  1. Untuk menetapkan batas memori saat membuat tugas:

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

    Ganti:

    • JOB_NAME dengan nama tugas Anda.
    • IMAGE_URL dengan referensi ke image container, misalnya, us-docker.pkg.dev/cloudrun/container/job:latest.
    • SIZE dengan ukuran memori yang diinginkan. 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.
  2. Untuk menetapkan batas memori saat Anda memperbarui tugas:

    gcloud run jobs update JOB_NAME --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_NAME --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
            resources:
              limits:
                memory: SIZE

    Ganti SIZE dengan ukuran memori yang diinginkan, 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. Perbarui konfigurasi tugas yang ada:

    gcloud run jobs replace job.yaml

Lihat setelan batas memori

Untuk melihat setelan batas memori saat ini pada tugas Cloud Run Anda:

Konsol

  1. Pada konsol Google Cloud, buka halaman tugas Cloud Run.

    Buka tugas Cloud Run

  2. Klik tugas yang Anda minati untuk membuka halaman Detail pekerjaan.

  3. Klik tab Konfigurasi.

  4. Temukan setelan batas memori dalam detail konfigurasi.

gcloud

  1. Gunakan perintah berikut:

    gcloud run jobs describe JOB_NAME
  2. Temukan setelan batas memori dalam konfigurasi yang ditampilkan.