Cloud Run menyediakan volume disk efemeral yang hanya bertahan selama durasi instance Anda. Fitur ini memungkinkan Anda menentukan jumlah disk yang diperlukan dan lokasi untuk memasangnya. Cloud Run kemudian akan mengalokasikan jumlah disk tersebut ke resource Anda.
Disk disediakan secara otomatis, diformat sebelumnya ke ext4, dan dienkripsi dengan kunci khusus instance saat startup. Ephemeral disk membuat volume Anda sehingga setiap pengguna dapat membaca atau menulis ke dalamnya. Karena penyimpanan bersifat sementara, semua data akan dihapus secara permanen saat instance dimatikan. Hal ini mencakup penutupan yang disebabkan oleh:
- Error instance
- Migrasi traffic ke revisi baru
Disk dikhususkan untuk instance tertentu dan tidak dibagikan ke instance atau revisi lain. Anda memiliki kontrol atas struktur sistem file dengan direktori pemasangan yang dapat dikonfigurasi untuk setiap volume.
Sebelum mematikan instance, Cloud Run mengirimkan sinyal SIGTERM
ke semua container dalam instance, yang menunjukkan dimulainya periode 10 detik
sebelum penonaktifan yang sebenarnya terjadi. Pada saat itu, Cloud Run mengirimkan
sinyal SIGKILL. Anda dapat menggunakan periode 10 detik ini untuk melakukan operasi pembersihan
seperti melakukan putaran terakhir penyalinan konten disk ke penyimpanan persisten.
Kasus penggunaan
Anda dapat menggunakan ephemeral disk untuk hal berikut:
- Workload pemrosesan data: Saat memproses file data besar di Cloud Run, Anda biasanya menyimpan seluruh file dalam memori atau mengatur pemisahannya menjadi beberapa bagian yang lebih kecil. Dengan penyimpanan sementara, Anda tidak perlu membayar sejumlah besar memori untuk membuat salinan lokal sementara data Anda. Anda juga dapat memproses set data yang lebih besar.
- Caching: Dalam kasus penggunaan penayangan web, menyimpan data di disk, bukan mengambilnya dari penyimpanan jarak jauh, dapat mengoptimalkan latensi aplikasi Anda.
Batas penyimpanan dan instance
Batasan berikut berlaku:
- Batas ukuran volume: setiap volume harus berukuran antara
1Gidan100Gi. - Batas penyimpanan instance: setiap instance dibatasi hingga total ruang 10 GiB secara default. Mengonfigurasi lebih dari 10 GiB per instance memerlukan permintaan penambahan kuota.
- Batas volume instance: setiap instance dibatasi hingga maksimum 10 volume disk efemeral.
- Batas project: setiap project dimulai dengan batas alokasi regional total sebesar 0 GiB secara default. Project otomatis diberi 100 GiB per region saat resource dengan disk sementara di-deploy di region tersebut untuk pertama kalinya. Saat runtime, kuota regional ini dibagikan ke semua instance yang berjalan aktif di region. Saat men-deploy resource, ukuran ephemeral disk gabungan per instance dikalikan dengan jumlah maksimum instance tidak boleh melebihi batas alokasi regional. Misalnya, dengan batas regional 100 GiB, resource dengan disk 10 GiB dapat dikonfigurasi dengan hingga 10 instance. Jika perlu, minta penambahan kuota.
Meminta penambahan kuota
Jika memerlukan kapasitas tambahan, Anda harus meminta penambahan kuota untuk kumpulan pekerja Cloud Run. Gunakan link yang disediakan di tombol berikut untuk meminta kuota yang Anda butuhkan.
| Kuota saat ini | Link kuota |
|---|---|
| 10 GiB per instance | Meminta kuota yang lebih besar per instance |
| 100 GiB per project | Meminta kuota yang lebih besar per project |
Untuk mengetahui informasi selengkapnya tentang cara meminta penambahan kuota, lihat Cara menambah kuota.
Batasan
Ephemeral disk hanya tersedia di lingkungan eksekusi generasi kedua. Secara default, pool worker Cloud Run menggunakan lingkungan eksekusi generasi kedua.Jalur yang tidak diizinkan
Cloud Run tidak mengizinkan Anda memasang volume di /dev, /proc, atau
/sys, atau di subdirektorinya.
Region yang didukung
Disk sementara tersedia di semua lokasi Cloud Run.
Sebelum memulai
- Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
- Instal dan lakukan inisialisasi gcloud CLI.
-
Perbarui komponen:
gcloud components update
- Tinjau halaman harga Cloud Run untuk CPU, memori, dan traffic keluar jaringan. Seluruh ukuran disk yang disediakan dan masa aktif instance yang menggunakannya berkontribusi pada biaya Anda.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan untuk mengonfigurasi ephemeral disk, minta administrator untuk memberi Anda peran IAM berikut:
- Cloud Run Developer (
roles/run.developer) di kumpulan pekerja 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 kumpulan worker Cloud Run Anda berinteraksi dengan APIGoogle Cloud , seperti Library Klien Cloud, lihat panduan konfigurasi identitas layanan. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat izin deployment dan mengelola akses.
Membuat dan memasang ephemeral disk
Anda dapat membuat dan memasang ephemeral disk menggunakan konsol Google Cloud , Google Cloud CLI, YAML, atau Terraform:
Konsol
Di konsol Google Cloud , buka halaman Cloud Run:
Pilih Worker pools dari menu navigasi Cloud Run:
Jika Anda mengonfigurasi pool worker yang sudah ada, klik pool worker, lalu klik Edit dan deploy revisi baru.
Jika Anda mengonfigurasi pool pekerja baru, klik Deploy container, lalu isi halaman pool pekerja awal. Kemudian, klik Containers, Networking, Security untuk meluaskan halaman konfigurasi kumpulan pekerja.
Klik tab Containers.
Centang kotak Ephemeral disk.
Tentukan ukuran disk sementara dari menu.
Masukkan jalur pemasangan.
Klik Buat atau Perbarui.
gcloud
Untuk menambahkan volume dan memasangnya:
gcloud beta run worker-pools update WORKERPOOL \
--add-volume=name=VOLUME_NAME,type=ephemeral-disk,size=SIZE \
--add-volume-mount=volume=VOLUME_NAME,mount-path=MOUNT_PATH
Ganti kode berikut:
- WORKERPOOL: nama pool pekerja Anda.
- VOLUME_NAME: nama yang ingin Anda berikan pada volume.
- SIZE: ukuran disk—misalnya,
10Gi. Ukuran harus antara1Gidan100Giuntuk volumeephemeral-disk. - MOUNT_PATH: jalur relatif tempat Anda memasang volume, misalnya,
/mnt/my-volume.
YAML
Jika Anda membuat kumpulan pekerja baru, lewati langkah ini. Jika Anda memperbarui kumpulan pekerja yang ada, download konfigurasi YAML-nya:
gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml
Konfigurasi file YAML:
apiVersion: run.googleapis.com/v1 kind: WorkerPool metadata: name: WORKER_POOL labels: cloud.googleapis.com/location: REGION annotations: run.googleapis.com/launch-stage: BETA spec: template: spec: containers: - name: CONTAINER_NAME image: IMAGE_URL volumeMounts: - name: VOLUME_NAME mountPath: MOUNT_PATH volumes: - name: VOLUME_NAME emptyDir: medium: Disk sizeLimit: SIZEGanti kode berikut:
- WORKER_POOL: nama pool pekerja Anda.
- REGION: Google Cloud region.
- CONTAINER_NAME: nama yang ingin Anda berikan pada container.
IMAGE_URL: referensi ke image container yang berisi kumpulan pekerja, sepertius-docker.pkg.dev/cloudrun/container/worker-pool:latest.- VOLUME_NAME: nama yang ingin Anda berikan pada volume.
- MOUNT_PATH: jalur relatif tempat Anda memasang volume, misalnya,
/mnt/my-volume. - SIZE: ukuran disk—misalnya,
10Gi. Ukuran harus antara1Gidan100Giuntuk volumeephemeral-disk.
Buat atau update kumpulan pekerja menggunakan perintah berikut:
gcloud run worker-pools replace worker-pool.yaml
Perintah
gcloud run worker-pools replacesecara default menggunakan fileworker-pool.yamljika ada.
Terraform
Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.
resource "google_cloud_run_v2_worker_pool" "default" {
name = "WORKER_POOL"
location = "REGION"
deletion_protection = "true"
launch_stage = "BETA"
template {
containers {
image = "IMAGE_URL"
volume_mounts {
name = "VOLUME_NAME"
mount_path = "MOUNT_PATH"
}
}
volumes {
name = "VOLUME_NAME"
empty_dir {
medium = "DISK"
size_limit = "SIZE"
}
}
}
lifecycle {
ignore_changes = [
launch_stage,
]
}
}
Ganti kode berikut:
- WORKER_POOL: nama pool pekerja Anda.
- REGION: Google Cloud region.
IMAGE_URL: referensi ke image container yang berisi kumpulan pekerja, sepertius-docker.pkg.dev/cloudrun/container/worker-pool:latest.- VOLUME_NAME: nama yang ingin Anda berikan pada volume.
- MOUNT_PATH: jalur relatif tempat Anda memasang volume, misalnya,
/mnt/my-volume. - SIZE: ukuran disk—misalnya,
10Gi. Ukuran harus antara1Gidan100Giuntuk volumeephemeral-disk.
Membaca dan menulis ke volume
Jika menggunakan fitur pemasangan volume Cloud Run, Anda mengakses volume yang dipasang menggunakan library yang sama dalam bahasa pemrograman yang Anda gunakan untuk membaca dan menulis file di sistem file lokal.
Cara ini sangat berguna jika Anda menggunakan container yang sudah ada yang mengharapkan data disimpan di sistem file lokal dan menggunakan operasi sistem file reguler untuk mengaksesnya.
Cuplikan berikut mengasumsikan pemasangan volume dengan mountPath yang ditetapkan ke /mnt/my-volume.
Nodejs
Gunakan modul Sistem File untuk membuat file baru atau menambahkan ke file yang ada
di volume, /mnt/my-volume:
var fs = require('fs');
fs.appendFileSync('/mnt/my-volume/sample-logfile.txt', 'Hello logs!', { flag: 'a+' });Python
Menulis ke file yang disimpan di volume, /mnt/my-volume:
f = open("/mnt/my-volume/sample-logfile.txt", "a")Go
Gunakan paket os untuk membuat file baru yang disimpan di volume, /mnt/my-volume:
f, err := os.Create("/mnt/my-volume/sample-logfile.txt")Java
Gunakan class Java.io.File untuk membuat file log di volume, /mnt/my-volume:
import java.io.File;
File f = new File("/mnt/my-volume/sample-logfile.txt");Menghapus dan menghapus volume dan pemasangan volume
Anda dapat menghapus semua volume dan pemasangan atau menghapus volume dan pemasangan volume satu per satu.
Menghapus semua volume dan pemasangan volume
Untuk menghapus semua volume dan pemasangan volume dari kumpulan pekerja satu penampung, jalankan perintah berikut:
gcloud run worker-pools update WORKER_POOL \ --clear-volumes \ --clear-volume-mounts
gcloud run worker-pools update WORKER_POOL \ --container=container1 \ --clear-volumes \ --clear-volume-mounts \ --container=container2 \ --clear-volumes \ --clear-volume-mounts
Menghapus volume dan pemasangan volume satu per satu
Untuk menghapus volume, Anda juga harus menghapus semua pemasangan volume yang menggunakan volume tersebut.
Untuk menghapus volume atau pemasangan volume tertentu, gunakan flag remove-volume dan remove-volume-mount:
gcloud run worker-pools update WORKER_POOL \ --remove-volume VOLUME_NAME \ --container=container1 \ --remove-volume-mount MOUNT_PATH \ --container=container2 \ --remove-volume-mount MOUNT_PATH
Praktik terbaik
Patuhi praktik terbaik berikut untuk mengelola data sementara secara efektif dan mengoptimalkan performa penyimpanan.
Menyalin ke penyimpanan persisten
Jika Anda ingin menyalin konten ephemeral disk ke penyimpanan persisten, seperti bucket Cloud Storage, sebaiknya salin secara inkremental, daripada mengandalkan masa tenggang 10 detik SIGTERM ke SIGKILL.
Lihat Kontrak runtime container
untuk mengetahui informasi selengkapnya tentang penonaktifan instance.
Cloud Run dapat membaca dan menulis dari Cloud Storage tanpa penyiapan jaringan tambahan. Untuk mendapatkan performa yang optimal, sebaiknya arahkan traffic ke dan dari Cloud Storage melalui Jaringan VPC menggunakan Direct VPC.
Metode ini berfungsi jika Anda tidak memerlukan resource Cloud Run untuk mengakses internet. Jika Anda memerlukan akses internet, siapkan Cloud NAT, atau lihat Traffic internal ke Google API.
Untuk mengonfigurasi Direct VPC egress dengan kumpulan pekerja, selesaikan langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Cloud Run:
Pilih Worker pools dari menu, lalu klik Deploy container untuk mengonfigurasi worker pool baru. Jika Anda mengonfigurasi pool worker yang ada, klik pool worker, lalu klik Edit dan deploy revisi baru.
Jika Anda mengonfigurasi kumpulan pekerja baru, isi halaman kumpulan pekerja awal, lalu klik Containers, Networking, Security untuk memperluas halaman konfigurasi kumpulan pekerja.
Klik tab Networking.
Pilih Hubungkan ke VPC.
Untuk Perutean traffic, pilih salah satu Rutekan semua traffic ke VPC untuk mengirim semua traffic keluar melalui jaringan VPC.
Klik Buat atau Deploy.
Kini Anda dapat mengirim permintaan dari kumpulan pekerja Cloud Run ke resource mana pun di jaringan VPC, sebagaimana diizinkan oleh aturan firewall Anda.
Aktifkan Akses Google Pribadi di subnet yang Anda hubungkan.