Halaman ini diterjemahkan oleh Cloud Translation API.

gcsfuse CLI

Halaman ini menjelaskan opsi command line gcsfuse yang digunakan untuk berinteraksi dengan Cloud Storage FUSE.

Synopsis

gcsfuse GLOBAL_OPTIONS BUCKET_NAME MOUNT_POINT

Dengan keterangan:

GLOBAL_OPTIONS adalah opsi yang mengontrol cara pemasangan dan perilaku Cloud Storage FUSE.
BUCKET_NAME adalah nama bucket yang akan dipasang. Misalnya, my-mount-bucket. Opsional. Kecualikan nama bucket dari perintah ini untuk menjalankan pemasangan dinamis.
MOUNT_POINT adalah direktori lokal tempat bucket akan dipasang. Misalnya, /path/to/mount/point.

Deskripsi

gcsfuse CLI digunakan untuk memasang bucket Cloud Storage sebagai sistem file di komputer lokal.

Opsi global

Opsi global	Deskripsi
`--anonymous-access BOOLEAN`	Menonaktifkan autentikasi untuk permintaan. Flag ini harus ditetapkan jika Anda menggunakan endpoint kustom yang tidak mendukung autentikasi. Flag ini juga harus ditetapkan jika Anda menggunakan Cloud Storage FUSE dengan bucket publik. Nilai defaultnya adalah `false`.
`--app-name VALUE`	Nama aplikasi pemasangan.
`--billing-project VALUE`	Menentukan project yang akan digunakan untuk penagihan saat bucket yang terpasang diakses. Flag ini sering diperlukan saat memasang bucket yang diaktifkan dengan Requester Pays. Project default tidak ada.
`--cache-dir VALUE`	Menentukan direktori untuk menyimpan data cache file. Catatan: Untuk mengaktifkan penyimpanan dalam cache file, Anda harus menentukan direktori menggunakan `--cache-dir` dan menggunakan flag `--file-cache-max-size-mb` untuk menentukan bilangan bulat positif yang menunjukkan batas ukuran cache file maksimum tertentu dalam mebibyte (MiB) atau menggunakan nilai `-1` untuk menentukan tidak ada batas.
`--client-protocol VALUE`	Menentukan protokol yang digunakan untuk berkomunikasi dengan backend Cloud Storage. Nilainya harus `http1` untuk HTTP/1.1 atau `http2` untuk HTTP/2. Nilai defaultnya adalah `http1`.
`--config-file VALUE`	Menentukan jalur ke file konfigurasi yang ingin Anda gunakan untuk mengonfigurasi perilaku Cloud Storage FUSE. Misalnya, `--config-file /etc/gcsfuse.yaml`
`--custom-endpoint VALUE`	Menentukan endpoint kustom alternatif untuk mengambil data. Endpoint kustom harus mendukung resource dan operasi yang setara dengan endpoint JSON Cloud Storage, `https://storage.googleapis.com/storage/v1`. Jika autentikasi tidak didukung di endpoint kustom yang Anda tentukan, tetapkan flag `--anonymous-access` ke `true` untuk mengabaikan autentikasi.
`--debug_fuse BOOLEAN`	Tidak digunakan lagi. Mengaktifkan output proses debug FUSE terkait. Opsi ini telah diganti dengan opsi `--log-severity`. Untuk mengaktifkan output proses debug, tetapkan opsi `--log-severity` ke `trace`, yang mencakup log rekaman aktivitas, debug, info, peringatan, dan error.
`--debug_gcs BOOLEAN`	Tidak digunakan lagi. Mencetak informasi permintaan dan pengaturan waktu Cloud Storage. Opsi ini telah diganti dengan opsi `--log-severity`. Untuk mengaktifkan output proses debug, tetapkan opsi `--log-severity` ke `trace`, yang mencakup log rekaman aktivitas, debug, info, peringatan, dan error.
`--debug_invariants BOOLEAN`	Keluar dari program saat pelanggaran invarian internal terdeteksi. Nilai defaultnya adalah `false`.
`--debug_mutex BOOLEAN`	Mencetak pesan debug saat mutex ditahan terlalu lama. Jika opsi ini ditentukan, tingkat keparahan log akan otomatis ditetapkan ke `trace`, yang mencakup log rekaman aktivitas, debug, info, peringatan, dan error. Nilai defaultnya adalah `false`.
`--dir-mode VALUE`	Bit izin akses untuk direktori, dalam oktal. Nilai minimum adalah `000` dan nilai maksimum adalah `777`. Nilai defaultnya adalah `755`.
`--enable-nonexistent-type-cache BOOLEAN`	Membuat entri cache jenis dengan jenis `NonexistentType` jika file tidak ditemukan di Cloud Storage. Jika file dibuat di Cloud Storage tetapi entri `NonexistentType` untuk file tersebut disimpan dalam cache, Cloud Storage FUSE tidak dapat meminta file tersebut hingga entri `NonexistentType` dihapus dari jenis cache. Nilai defaultnya adalah `false`.
`--file-cache-cache-file-for-range-read BOOLEAN`	Menentukan apakah objek lengkap harus didownload secara asinkron dan disimpan di direktori cache Cloud Storage FUSE saat pembacaan pertama selesai dari offset non-nol. Flag ini harus disetel ke `true` jika Anda berencana melakukan beberapa pembacaan acak atau pembacaan sebagian. Jika kolom ini tidak ditentukan, nilai defaultnya adalah `false`. Catatan: Jika Anda melakukan pembacaan sebagian yang dimulai dari offset `0`, Cloud Storage FUSE akan mendownload dan meng-cache objek lengkap secara asinkron.
`--file-cache-download-chunk-size-mb VALUE`	Menentukan ukuran setiap permintaan baca dalam MiB yang dibuat oleh setiap goroutine ke Cloud Storage saat mendownload objek ke cache file. Nilai defaultnya adalah `50`.
`--file-cache-enable-parallel-downloads BOOLEAN`	Mempercepat pembacaan file besar dengan menggunakan direktori cache file sebagai buffering pengambilan data menggunakan beberapa pekerja untuk mendownload file besar secara paralel. Nilai defaultnya adalah `false`. Untuk menggunakan download paralel, Anda harus mengaktifkan penyimpanan dalam cache file. Untuk mempelajari download paralel lebih lanjut dan mengonfigurasi properti pendukungnya, lihat Meningkatkan performa baca menggunakan download paralel.
`--file-cache-max-parallel-downloads VALUE`	Jumlah maksimum goroutine yang dapat dibuat pada waktu tertentu di semua tugas download file. Nilai defaultnya adalah dua kali jumlah core CPU di komputer Anda atau `16`, mana saja yang lebih tinggi. Untuk menentukan tidak ada batas, masukkan nilai `-1`.
`--file-mode VALUE`	Menentukan bit izin untuk file, dalam oktal. Nilai minimum adalah `000` dan nilai maksimum adalah `777`. Nilai defaultnya adalah `644`.
`--foreground BOOLEAN`	Menjalankan perintah `gcsfuse` di latar depan. Nilai defaultnya adalah `false`.
`--gid VALUE`	Menentukan pemilik ID Grup (GID) dari semua inode. Nilai harus berupa bilangan bulat. Nilai defaultnya adalah `-1`.
`--help` atau `-h`	Menampilkan bantuan tentang Cloud Storage FUSE.
`version` atau `-v`	Menampilkan versi Cloud Storage FUSE yang telah diinstal.
`--http-client-timeout VALUE`	Menentukan durasi tunggu klien HTTP Cloud Storage FUSE untuk mendapatkan respons dari server sebelum waktu habis. Nilai harus berupa durasi waktu. Misalnya, `1h10m10s`. Nilai defaultnya adalah `0s`, yang menunjukkan tidak ada waktu tunggu.
`--ignore-interrupts VALUE`	Memberi petunjuk kepada Cloud Storage FUSE untuk mengabaikan sinyal interupsi sistem, seperti SIGINT yang dipicu oleh `Control+C`. Hal ini mencegah sinyal menghentikan operasi yang sedang berlangsung. Nilainya adalah `true` atau `false`. Nilai defaultnya adalah `true`.
`--implicit-dirs BOOLEAN`	Secara implisit menyertakan folder dan folder terkelola. Lihat dokumentasi file dan direktori di GitHub untuk informasi selengkapnya. Nilai defaultnya adalah `false`.
`--kernel-list-cache-ttl-secs VALUE`	Mengaktifkan cache daftar dan menentukan time to live (TTL) dalam hitungan detik dari entri daftar yang di-cache. Cache daftar disimpan dalam memori di cache halaman, yang dikontrol oleh kernel berdasarkan memori yang tersedia. Nilai defaultnya adalah `0` yang menonaktifkan penyimpanan dalam cache daftar. Untuk menetapkan tanda `--kernel-list-cache-ttl-secs`, tentukan nilai bilangan bulat positif dalam detik untuk menyimpan respons daftar direktori di cache halaman kernel. Untuk mengabaikan masa berlaku entri dan selalu menampilkan respons daftar dari cache jika tersedia, tentukan nilai `-1`.
`--key-file VALUE`	Menentukan jalur absolut ke file kunci JSON kredensial untuk mengautentikasi permintaan ke Cloud Storage. Secara default, Cloud Storage FUSE menggunakan Kredensial Default Aplikasi untuk mengautentikasi permintaan.
`--limit-bytes-per-sec VALUE`	Menentukan batas bandwidth yang dapat digunakan Cloud Storage FUSE untuk membaca data dari Cloud Storage, yang diukur selama periode 30 detik. Nilai harus berupa bilangan floating point. Nilai defaultnya adalah `-1`, yang tidak menentukan batas.
`--limit-ops-per-sec VALUE`	Menentukan batas untuk operasi yang dijalankan per detik, yang diukur selama periode 30 detik. Nilai harus berupa bilangan floating point. Nilai defaultnya adalah `-1`, yang menentukan tidak ada batas.
`--log-file VALUE`	Menentukan file untuk menyimpan log yang dapat diurai oleh Fluentd. Jika tidak diberikan, log teks biasa akan dicetak ke `stdout` saat Cloud Storage FUSE dijalankan di latar depan, atau ke `syslog` saat Cloud Storage FUSE dijalankan di latar belakang.
`--log-format VALUE`	Menentukan format file log. Nilainya harus berupa `text` atau `json`. Nilai defaultnya adalah `json`.
`--log-rotate-backup-file-count VALUE`	Jumlah maksimum file log yang dirotasi untuk dipertahankan, tidak termasuk file aktif tempat log ditulis. Jika nilai ditetapkan ke `0`, semua file log yang dirotasi akan dipertahankan. Jika kolom ini tidak ditentukan, nilainya akan ditetapkan secara default ke `10`.
`--log-rotate-compress BOOLEAN`	Nilai boolean yang menentukan apakah file log yang dirotasi dikompresi menggunakan `gzip`. Jika tanda ini tidak ditentukan, nilai defaultnya adalah `true`.
`--log-rotate-max-file-size-mb VALUE`	Ukuran maksimum dalam megabyte (MB) yang dapat dicapai file log sebelum dirotasi. Nilai minimumnya adalah `1`. Jika kolom ini tidak ditentukan, nilai defaultnya adalah `512`.
`--log-severity ENUM`	Tingkat keparahan log yang Anda inginkan untuk dihasilkan oleh Cloud Storage FUSE, yang dinyatakan sebagai enum. Tingkat keparahan diurutkan dari tingkat keparahan terendah hingga tertinggi: `trace` `debug` `info` `warning` `error` Saat Anda menentukan tingkat keparahan, Cloud Storage FUSE akan menghasilkan log yang memiliki tingkat keparahan yang sama atau lebih tinggi. Misalnya, saat Anda menentukan `warning`, Cloud Storage FUSE akan menghasilkan log untuk peringatan dan error. Secara umum, sebaiknya gunakan tingkat keparahan `info`. Anda juga dapat menentukan `off` untuk menonaktifkan semua logging. Jika Anda menentukan `--debug_mutex` sebagai bagian dari perintah, tingkat keparahan akan otomatis ditetapkan ke `trace` dan mengganti `log-severity`. Jika kolom ini tidak ditentukan, nilai defaultnya adalah `info`. Catatan: Menggunakan tingkat keparahan `trace` atau `debug` saat caching file diaktifkan dapat menyebabkan penurunan performa karena overhead logging dan hanya boleh digunakan untuk sementara, seperti selama pemecahan masalah.
`--max-conns-per-host VALUE`	Menentukan jumlah maksimum koneksi TCP yang diizinkan per server. Hal ini mulai berlaku jika `--client-protocol` ditetapkan ke `http1`. Nilai harus antara `0` hingga `2147483647`. Nilai defaultnya adalah `0`, yang menentukan bahwa tidak ada batasan pada koneksi TCP kecuali untuk batasan yang ditetapkan oleh spesifikasi mesin Anda.
`--max-idle-conns-per-host VALUE`	Menentukan jumlah maksimum koneksi tidak ada aktivitas yang diizinkan per server. Nilainya harus antara `0` hingga `2147483647`. Nilai defaultnya adalah `100`.
`--max-retry-sleep VALUE`	Menentukan durasi maksimum yang diizinkan Cloud Storage FUSE untuk tidur dalam loop percobaan ulang dengan backoff eksponensial. Nilai harus berupa nilai durasi waktu. Misalnya, `1h5m50s` (1 jam, 5 menit, dan 50 detik) atau `60s` (60 detik). Setelah durasi backoff melebihi durasi maksimum yang ditentukan, percobaan ulang akan dilanjutkan dengan durasi maksimum yang ditentukan. Nilai defaultnya adalah `30s`.
`--metadata-cache-ttl-secs VALUE`	Menentukan time to live (TTL) dalam detik dari entri metadata yang di-cache. Untuk mengabaikan masa berlaku TTL dan menayangkan file dari cache setiap kali tersedia, tentukan nilai `-1`. Untuk menggunakan file terbaru, tentukan nilai `0`. Penggunaan nilai ini akan mengeluarkan panggilan metadata `Get` untuk memastikan bahwa pembuatan objek untuk file dalam cache cocok dengan yang disimpan di Cloud Storage. Untuk mempelajari lebih lanjut, lihat Mengonfigurasi pembatalan cache. Jika kolom ini tidak ditentukan, nilai defaultnya adalah `60` (60 detik).
`-o VALUE`	Menentukan opsi pemasangan tambahan khusus sistem. Sebagian besar opsi pemasangan umum di `FUSE` seperti `suid` didukung oleh Cloud Storage FUSE dan dapat diteruskan bersama dengan flag `-o`. Beberapa opsi pemasangan yang umum digunakan dan tersedia dengan flag `-o` mencakup hal berikut: `rw`: memasang sebagai baca-tulis. `ro`: memasang sebagai hanya baca. Untuk informasi selengkapnya tentang opsi pemasangan lain yang didukung, lihat dokumentasi Linux FUSE.
`--only-dir VALUE`	Hanya memasang direktori tertentu dalam bucket.
`--rename-dir-limit VALUE`	Mengizinkan penggantian nama direktori yang berisi turunan yang lebih sedikit dari batas yang ditentukan. Nilai harus antara `0` hingga `2147483647`. Nilai batas default adalah `0`.
`--retry-multiplier VALUE`	Menentukan pengganda untuk backoff eksponensial di antara percobaan ulang berturut-turut. Nilai harus berupa bilangan floating point. Nilai defaultnya adalah `2`.
`--reuse-token-from-url`	Menentukan apakah akan menggunakan kembali token yang diperoleh dari `--token-url`. Nilai defaultnya adalah `true`.
`--sequential-read-size-mb VALUE`	Menentukan ukuran potongan data yang akan didownload dari Cloud Storage, dalam megabyte (MB). Nilai harus antara `1` dan `1024`. Nilai defaultnya adalah `200`.
`--stackdriver-export-interval VALUE`	Mengekspor metrik ke stackdriver dengan interval yang ditentukan. Nilai harus berupa durasi waktu. Misalnya, `1h10m10s`. Nilai defaultnya adalah `0s`, yang menentukan tidak ada ekspor.
`--stat-cache-capacity VALUE`	Tidak digunakan lagi. Menentukan jumlah entri yang dapat disimpan oleh cache statistik. Hal ini memengaruhi konsumsi memori. Nilai harus berupa bilangan bulat. Nilai defaultnya adalah `4096`. Tanda ini telah diganti dengan `--stat-cache-max-size-mb`. Untuk menentukan ukuran maksimum dalam mebibyte (MiB) yang dapat digunakan cache statistik, gunakan flag `--stat-cache-max-size-mb`.
`--stat-cache-max-size-mb VALUE`	Ukuran maksimum dalam mebibyte (MiB) yang dapat digunakan cache statistik. Cache statis selalu disimpan sepenuhnya dalam memori. Tentukan nilai `32` jika beban kerja Anda melibatkan hingga 20.000 file. Jika beban kerja Anda lebih besar dari 20.000 file, tingkatkan ukuran dengan nilai 10 untuk setiap tambahan 6.000 file, dengan cache statis menggunakan rata-rata 1.500 MiB per file. Agar cache statistik menggunakan memori sebanyak yang diperlukan, yang berarti tidak menetapkan batas, tentukan nilai `-1`. Untuk menonaktifkan cache statistik, tentukan nilai `0`. Jika kolom ini tidak ditentukan, nilai defaultnya adalah `32`.
`--stat-cache-ttl VALUE`	Tidak digunakan lagi. Menentukan durasi penyimpanan atribut `StatObject` dan inode ke dalam cache. Nilai default-nya adalah `60s` (60 detik). Flag ini telah diganti dengan `--metadata-cache-ttl-secs`. Untuk menentukan time to live (TTL) dalam detik untuk entri metadata yang di-cache, gunakan flag `--metadata-cache-ttl-secs`.
`--temp-dir VALUE`	Menentukan jalur ke direktori sementara tempat penulisan dirilis bertahap untuk pengujian sebelum diupload ke Cloud Storage. Nilai defaultnya adalah default sistem Anda, kemungkinan besar `/tmp`.
`--token-url VALUE`	Menentukan URL untuk mendapatkan token akses jika `--key-file` tidak ada.
`--type-cache-ttl VALUE`	Tidak digunakan lagi. Menentukan durasi penyimpanan pemetaan antara nama dan file atau direktori dalam cache di inode direktori. Opsi ini telah diganti dengan opsi `--metadata-cache-ttl-secs`. Untuk menentukan durasi yang ingin Anda tetapkan untuk cache jenis, gunakan opsi `--metadata-cache-ttl-secs`, yang menentukan time to live (TTL) entri metadata dari cache statistik dan jenis. Nilai default untuk `--metadata-cache-ttl-secs` adalah `60s` (60 detik).
`--type-cache-max-size-mb VALUE`	Ukuran maksimum dalam MiB per direktori yang dapat digunakan cache jenis. Cache jenis selalu disimpan sepenuhnya di memori. Tentukan nilai `4` jika jumlah maksimum file dalam satu direktori dari bucket yang Anda pasang berisi 20.000 file atau kurang. Jika jumlah maksimum file dalam satu direktori yang Anda pasang berisi lebih dari 20.000 file, tingkatkan nilai sebesar `1` untuk setiap 5.000 file, yang merupakan rata-rata sekitar 200 byte per file. Agar cache jenis dapat menggunakan memori sebanyak yang diperlukan, dengan kata lain, untuk menentukan tidak ada batas, tentukan nilai `-1`. Untuk menonaktifkan cache jenis, tentukan nilai `0`. Jika kolom ini tidak ditentukan, nilai defaultnya adalah `4`.
`--uid VALUE`	Menentukan pemilik ID Pengguna (UID) semua inode. Nilai harus berupa bilangan bulat. Nilai UID default adalah `-1`.