gcsfuse CLI

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

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. Penanda ini harus diatur 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.
--client-protocol VALUE Menentukan protokol yang digunakan untuk berkomunikasi dengan backend Cloud Storage. Nilainya dapat berupa 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 seperti endpoint JSON Cloud Storage, https://storage.googleapis.com/storage/v1. Jika endpoint kustom tidak ditentukan, Cloud Storage FUSE menggunakan Endpoint Cloud Storage JSON API, https://storage.googleapis.com/storage/v1. Jika autentikasi tidak didukung di endpoint kustom yang Anda tentukan, tetapkan flag --anonymous-access ke true untuk mengabaikan otentikasi.
--debug_fuse_errors Jika dikecualikan, bernilai Salah dan mencegah Error FUSE agar tidak dicatat ke konsol (jika --foreground digunakan) atau file log (jika --log-file digunakan).
--debug_fuse Mengaktifkan output proses debug FUSE terkait. Jika opsi ini ditentukan, tingkat keparahan log akan otomatis ditetapkan ke trace, yang mencakup log rekaman aktivitas, log debug, log info, log peringatan, dan log error.
--debug_gcs Mencetak informasi permintaan dan pengaturan waktu Cloud Storage. Jika opsi ini ditentukan, tingkat keparahan log akan otomatis ditetapkan ke trace, yang mencakup log rekaman aktivitas, log debug, log info, log peringatan, dan log error.
--debug-invariants Panik saat invarian internal dilanggar.
--debug_mutex 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, log debug, log info, log peringatan, dan log error.
--dir-mode VALUE Bit izin akses untuk direktori, dalam oktal. Nilai defaultnya adalah 755.
--enable-nonexistent-type-cache 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.
--experimental-enable-json-read Menentukan Cloud Storage FUSE agar dapat menggunakan Cloud Storage JSON API untuk operasi baca. Secara default, operasi baca dijalankan menggunakan Cloud Storage XML API.
--experimental-opentelemetry-collector-address VALUE Mengekspor metrik ke OpenTelemetry Collector di alamat yang ditentukan. Eksperimental.
--file-mode VALUE Menentukan bit izin untuk file, dalam oktal. Nilai defaultnya adalah 644.
--foreground Menjalankan perintah gcsfuse di latar depan.
--gid VALUE Menentukan pemilik ID Grup (GID) dari semua inode. Nilai GID default adalah -1.
--help atau -h Menampilkan bantuan tentang Cloud Storage FUSE.
--http-client-timeout VALUE Menentukan durasi tunggu klien HTTP Cloud Storage FUSE untuk mendapatkan respons dari server sebelum waktu habis. Nilai defaultnya adalah 0s, yang menunjukkan tidak ada waktu tunggu.
--ignore-interrupts VALUE Meminta Cloud Storage FUSE untuk mengabaikan sinyal interupsi sistem, seperti SIGINT dipicu oleh Control+C. Hal ini mencegah sinyal dari menghentikan operasi penerbangan. Nilainya adalah true atau false. Nilai defaultnya adalah true.
--implicit-dirs

Secara implisit menyertakan folder dan folder terkelola.

Lihat dokumentasi file dan direktori di GitHub untuk informasi selengkapnya.
--kernel-list-cache-ttl-secs VALUE Mengaktifkan daftar cache dan menentukan time to live (TTL) dalam detik dari cache entri daftar. Cache daftar disimpan di memori pada cache halaman, yang dikendalikan oleh {i>kernel<i} berdasarkan memori yang tersedia. Nilai defaultnya adalah 0 yang menonaktifkan pembuatan cache daftar.

Untuk menetapkan flag --kernel-list-cache-ttl-secs, tentukan nilai positif dalam hitungan detik untuk menyimpan respons daftar direktori dalam cache halaman kernel. Untuk mengabaikan masa berlaku entri dan selalu menampilkan daftar dari cache saat 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 batas default adalah -1, yang menentukan tidak ada batas.
--limit-ops-per-sec VALUE Menentukan batas untuk operasi yang dijalankan per detik, yang diukur selama periode 30 detik. Nilai batas default adalah -1, yang tidak menentukan batas.
--log-file VALUE Menentukan file untuk menyimpan log yang dapat diurai oleh Fluentd. Jika tidak disediakan, log teks biasa akan dicetak ke stdout saat Cloud Storage FUSE dijalankan di latar depan, atau ke syslog saat Cloud Storage FUSE berjalan di latar belakang.
--log-format VALUE Menentukan format file log. Nilainya dapat berupa text atau json. Nilai defaultnya adalah json.
--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 defaultnya adalah 0, yang menentukan bahwa tidak ada batasan pada koneksi TCP kecuali untuk batasan yang ditetapkan oleh spesifikasi mesin.
--max-idle-conns-per-host VALUE Menentukan jumlah maksimum koneksi tidak ada aktivitas yang diizinkan per server. Nilai defaultnya adalah 100.
--max-retry-sleep VALUE Menentukan durasi maksimum yang diizinkan untuk tidur di FUSE Cloud Storage melakukan loop percobaan ulang dengan backoff eksponensial. Setelah durasi backoff melebihi durasi maksimum yang ditentukan, percobaan ulang akan berlanjut dengan durasi maksimum yang ditentukan. Nilai batas default-nya adalah 30s (30 detik).
-o VALUE

Menentukan opsi pemasangan tambahan khusus sistem.

Sebagian besar opsi pemasangan umum di FUSE (seperti rw dan suid) didukung oleh Cloud Storage FUSE dan dapat diteruskan bersama dengan flag -o. Untuk detail selengkapnya, lihat dokumentasi Linux FUSE.

-o ro Memasang bucket sebagai hanya baca.
--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 batas default adalah 0.
--retry-multiplier VALUE Menentukan backoff eksponensial di antara percobaan ulang, dengan nilai pengganda untuk waktu tunggu berikutnya berdasarkan waktu tunggu sebelumnya baik.
--reuse-token-from-url IJika disertakan, nilai True dan menentukan bahwa token yang diperoleh dari --token-url akan digunakan. Jika dikecualikan, evaluasi ke Salah (False) dan menentukan bahwa token yang diperoleh dari --token-url tidak boleh digunakan kembali.
--sequential-read-size-mb VALUE Menentukan ukuran potongan data yang akan didownload dari Cloud Storage, dalam megabyte (MB).
--stackdriver-export-interval VALUE Mengekspor metrik ke stackdriver dengan interval yang ditentukan. Nilai defaultnya adalah 0s, yang menentukan tidak ada ekspor.
--stat-cache-capacity VALUE Tidak digunakan lagi. Menentukan jumlah entri yang di-cache statistik dapat disimpan. Hal ini memengaruhi konsumsi memori. Nilai defaultnya adalah 4096.

Gunakan metadata-cache: stat-cache max-size, bukan flag ini di file konfigurasi untuk menyetel ukuran maksimum cache statistik. Untuk informasi selengkapnya, lihat File konfigurasi FUSE Cloud Storage.
--stat-cache-ttl VALUE Tidak digunakan lagi. Menentukan durasi cache StatObject hasil dan atribut {i>inode<i}. Nilai defaultnya adalah 60s.

Gunakan kolom metadata-cache: ttl-secs, bukan flag ini di file konfigurasi untuk menentukan time to live (TTL) entri metadata dari cache statistik maupun jenis. Sebagai informasi selengkapnya, lihat file konfigurasi FUSE Cloud Storage.
--type-cache-ttl VALUE Tidak digunakan lagi. Menentukan berapa lama cache pemetaan antara nama dan file atau direktori di inode direktori. Nilai defaultnya adalah 60s.

Sebagai gantinya, gunakan kolom metadata-cache: ttl-secs untuk menentukan time to live (TTL) entri metadata dari cache statistik dan jenis. Untuk mengetahui informasi selengkapnya, lihat file konfigurasi Cloud Storage FUSE.
--temp-dir value 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.
--uid VALUE Menentukan pemilik ID Pengguna (UID) semua inode. Nilai UID defaultnya adalah -1.
--version atau -v Menampilkan versi Cloud Storage FUSE yang telah diinstal.