Halaman ini diterjemahkan oleh Cloud Translation API.

Mengonfigurasi pemasangan volume dalam memori untuk tugas

Halaman ini menjelaskan cara mengonfigurasi volume khusus dalam memori yang dapat Anda gunakan untuk pembacaan dan penulisan file menggunakan pemasangan volume Cloud Run. Perlu diperhatikan bahwa fitur ini berbeda dengan sistem file dalam memori bawaan yang disediakan oleh Cloud Run.

Anda dapat menggunakan volume dalam memori untuk melakukan hal berikut:

Batasi ukuran volume dalam memori. Jika Anda membatasi ukuran volume, operasi tulis ke volume penuh akan gagal. Oleh karena itu, akan lebih baik jika Cloud Run menghentikan instance karena volume yang digunakan terlalu banyak memori.
Berbagi volume dalam memori di antara container yang berbeda dalam satu instance Cloud Run.

Perilaku

Saat membuat volume dalam memori, sebaiknya tentukan batas ukuran. Jika volume mencapai batas ukurannya, operasi tulis lebih lanjut akan gagal dengan error kehabisan memori. Instance Anda dapat menangani error ini dan tetap berjalan.

Perlu diperhatikan bahwa batas ukuran hanyalah batas: batas ini tidak mengalokasikan ruang tambahan untuk volume dalam memori Anda. Sebaliknya, volume dalam memori Anda memakai memori yang Anda konfigurasikan untuk container. Jika Anda men-deploy beberapa container, memori yang digunakan oleh setiap penulisan ke volume dihitung sebagai penggunaan memori untuk container yang menulis data.

Jika Anda tidak menentukan batas ukuran, batas ini akan otomatis disetel menjadi setengah dari total ukuran semua container dalam tugas atau layanan Anda. Misalnya, ukuran volume emptyDir = [Memori (Container A) + Memori (Container B) + Memori (Container N)]/2. Perilaku default ini dapat mengakibatkan batas ukuran volume dalam memori lebih tinggi daripada memori yang dialokasikan untuk beberapa container Anda. Dalam situasi ini, jika container Anda terus menulis memori ke volume, container akan melampaui memori yang dialokasikan dan error sebelum batas ukuran volume tercapai.

Meskipun menetapkan batas ukuran bersifat opsional, sebaiknya tetapkan batas ukuran untuk melindungi container agar tidak kehabisan memori dan tidak bekerja.

Kepemilikan volume berbeda berdasarkan lingkungan eksekusi dan jenis deployment

Saat Anda memasang volume, identitas yang memiliki file dan direktori akan berbeda bergantung pada lingkungan eksekusi workload dan apakah deployment terdiri dari satu atau banyak container.

Di lingkungan eksekusi generasi pertama tempat Anda men-deploy satu container, volumenya dimiliki oleh identitas yang digunakan untuk container. Dalam kasus lainnya, volume dimiliki oleh root. Hal ini mencakup:

Lingkungan eksekusi generasi pertama tempat Anda men-deploy banyak container
Lingkungan generasi kedua

Mengonfigurasi volume dalam 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.

Setelah Anda mengonfigurasi volume dalam memori untuk layanan Cloud Run Anda, volume kosong akan dibuat untuk setiap instance Cloud Run yang dimulai, dan volume tersebut ada selama instance tersebut berjalan. Saat instance berhenti berjalan, data dalam volume akan dihapus secara permanen.

Command line

Untuk menambahkan volume dan memasangnya:
```
gcloud beta run jobs update JOB \
--add-volume=name=VOLUME_NAME,type=in-memory,size-limit=SIZE_LIMIT \
--add-volume-mount=volume=VOLUME_NAME,mount-path=MOUNT_PATH
```
Ganti:
- JOB dengan nama tugas Anda.
- VOLUME_NAME dengan nama apa pun yang Anda inginkan untuk volume. Nilai VOLUME_NAME digunakan untuk memetakan volume ke pemasangan volume.
- MOUNT_PATH dengan jalur relatif dalam sistem file container tempat Anda ingin memasang volume ini, misalnya, /cache.
- SIZE_LIMIT dengan batas memori yang ingin Anda tetapkan ke volume, dalam MiB atau GiB (ditetapkan sebagai Mi atau Gi), misalnya, 500Mi. Batas ini harus kurang dari total memori yang ditentukan untuk container Anda.

Jika Anda menggunakan beberapa container, tentukan volume terlebih dahulu, lalu tentukan pemasangan volume untuk setiap container:

gcloud beta run jobs update JOB \
--add-volume=name= VOLUME_NAME,type=in-memory,size-limit=SIZE_LIMIT \
--container=CONTAINER_1 \
--add-volume-mount=volume= VOLUME_NAME,mount-path=MOUNT_PATH \
--container==CONTAINER_2 \
--add-volume-mount=volume= VOLUME_NAME,mount-path=MOUNT_PATH2

YAML

Jika Anda membuat tugas baru, lewati langkah ini. Jika Anda memperbarui tugas yang sudah ada, download Konfigurasi YAML:
```
gcloud run jobs describe JOB_NAME --format export > job.yaml
```
Konfigurasikan atribut volumeMounts dan volumes seperti yang ditunjukkan:
```
apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB_NAME
metadata:
 annotations:
  run.googleapis.com/launch-stage: BETA
spec:
  template:
    metadata:
    spec:
      containers:
      - image: IMAGE_URL
        volumeMounts:
        - mountPath: MOUNT_PATH
          name: VOLUME_NAME
      volumes:
      - name: VOLUME_NAME
        emptyDir:
          sizeLimit: SIZE_LIMIT
          medium: Memory
```
Ganti:
- IMAGE_URL dengan referensi ke image container, misalnya, us-docker.pkg.dev/cloudrun/container/hello:latest. Jika Anda menggunakan Artifact Registry, repositori REPO_NAME harus sudah dibuat. URL berbentuk LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
- VOLUME_NAME dengan nama apa pun yang Anda inginkan untuk volume. Nilai VOLUME_NAME digunakan untuk memetakan volume ke pemasangan volume.
- MOUNT_PATH dengan jalur relatif dalam sistem file container tempat Anda ingin memasang volume ini, misalnya, /cache.
- SIZE_LIMIT dengan batas memori yang ingin Anda tetapkan ke volume, dalam MiB atau GiB (ditetapkan sebagai Mi atau Gi), misalnya, 500Mi. Batas ini harus kurang dari total memori yang ditentukan untuk container Anda.
Ganti layanan dengan konfigurasi barunya menggunakan perintah berikut:
```
gcloud beta run jobs replace job.yaml
```