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. Contoh, /path/to/mount/point.

Deskripsi

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

Opsi global

Opsi global Deskripsi
--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. Sebaiknya hanya digunakan untuk pengujian. Endpoint kustom harus mendukung resource dan operasi yang setara dengan endpoint JSON Cloud Storage, https://storage.googleapis.com/storage/v1. Jika endpoint kustom tidak ditentukan, Cloud Storage FUSE akan menggunakan endpoint Cloud Storage JSON API global, https://storage.googleapis.com/storage/v1. Jika endpoint kustom ditentukan, autentikasi akan dinonaktifkan di endpoint.
--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.
--implicit-dirs

Secara implisit menyertakan folder dan folder terkelola.

Lihat dokumentasi file dan direktori di GitHub untuk informasi selengkapnya.
--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 dijalankan 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 100.
--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 Cloud Storage FUSE yang diizinkan untuk tidur dalam loop percobaan ulang dengan backoff eksponensial. Setelah durasi backoff melebihi durasi maksimum yang ditentukan, percobaan ulang akan berlanjut dengan durasi maksimum yang ditetapkan. Nilai batas default 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 waktu tunggu antara dua percobaan ulang berturut-turut.
--reuse-token-from-url IJika disertakan, nilai True dan menentukan bahwa token yang diperoleh dari --token-url akan digunakan. Jika dikecualikan, bernilai 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 dapat ditampung cache statistik. Hal ini memengaruhi konsumsi memori. Nilai defaultnya adalah 4096.
--stat-cache-ttl VALUE Tidak digunakan lagi. Menentukan durasi penyimpanan hasil StatObject dan atribut inode ke dalam cache. Nilai defaultnya adalah 1m0s.
--type-cache-ttl VALUE Tidak digunakan lagi. Menentukan durasi cache pemetaan antara nama dan file atau direktori dalam inode direktori. Nilai defaultnya adalah 60s.
--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 default adalah -1.
--version atau -v Menampilkan versi Cloud Storage FUSE yang telah diinstal.