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 minimum 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:
-
Cloud Run Developer (
roles/run.developer
) di tugas Cloud Run -
Service Account User (
roles/iam.serviceAccountUser
) di 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. Untuk menentukan memori untuk tugas Cloud Run:
Di konsol Google Cloud , buka halaman tugas Cloud Run:
Klik Deploy container dan pilih Job untuk mengisi halaman setelan tugas awal. Jika Anda mengonfigurasi tugas yang sudah ada, pilih tugas, lalu klik Edit.
Klik Container, variabel dan secret, koneksi, keamanan untuk memperluas halaman properti tugas.
Klik tab Container.
- Pilih ukuran memori yang diinginkan dari menu drop-down Memory.
Klik Buat atau Perbarui.
Untuk menetapkan batas memori saat membuat tugas:
gcloud run jobs create
JOB_NAME --imageIMAGE_URL --memorySIZE 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
atauM
yang sesuai dengan gigabyte atau megabyte, atau menggunakan pangkat dua yang setaraGi
atauMi
yang sesuai dengan gibibyte atau mebibyte.
Untuk menetapkan batas memori saat Anda memperbarui tugas:
gcloud run jobs update
JOB_NAME --memorySIZE
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.yamlPerbarui 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
atauM
yang sesuai dengan gigabyte atau megabyte, atau gunakan pangkat dua yang setara:Gi
atauMi
yang sesuai dengan gibibyte atau mebibyte.Anda juga dapat menentukan konfigurasi lainnya, seperti variabel lingkungan atau batas memori.
Perbarui konfigurasi job yang ada:
gcloud run jobs replace job.yaml
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.
Di bagian template.containers.resources.limits.memory
,
ganti SIZE
dengan 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.
resource "google_cloud_run_v2_job" "default" {
name = "cloudrun-job"
location = "us-central1"
deletion_protection = false
template {
template {
containers {
image = "us-docker.pkg.dev/cloudrun/container/job"
resources {
limits = {
cpu = "2"
memory = "SIZE "
}
}
}
}
}
}
Lihat setelan batas memori
Untuk melihat setelan batas memori saat ini pada tugas Cloud Run Anda:
Di konsol Google Cloud , buka halaman tugas Cloud Run:
Klik tugas yang Anda minati untuk membuka halaman Detail pekerjaan.
Klik tab Konfigurasi.
Temukan setelan batas memori dalam detail konfigurasi.
Gunakan perintah berikut:
gcloud run jobs describe
JOB_NAME Temukan setelan batas memori dalam konfigurasi yang ditampilkan.