gcsfuse CLI

Halaman ini menjelaskan opsi command line gcsfuse yang digunakan untuk berinteraksi dengan Cloud Storage FUSE. Jika Anda menggunakan driver CSI Cloud Storage FUSE untuk memasang bucket ke sistem file lokal di Google Kubernetes Engine, lihat Opsi pemasangan untuk driver CSI 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 Deskripsi Nilai yang valid Nilai default
--anonymous-access Menonaktifkan autentikasi untuk permintaan. Opsi ini harus ditetapkan jika Anda menggunakan endpoint kustom yang tidak mendukung autentikasi. Opsi ini juga harus ditetapkan jika Anda menggunakan Cloud Storage FUSE dengan bucket publik. Nilai boolean: true, false. false
--app-name Nama aplikasi pemasangan. Nilai string, misalnya: my-bucket-mount. ""
--billing-project Menentukan project yang akan digunakan untuk penagihan saat bucket yang terpasang diakses. Opsi ini sering diperlukan saat memasang bucket yang diaktifkan dengan Requester Pays. Nilai string yang mewakili project ID. ""
--cache-dir

Menentukan direktori untuk menyimpan data cache file.

Untuk mempelajari cara mengaktifkan penyimpanan dalam cache file, lihat Menggunakan penyimpanan dalam cache file.

 Jalur, misalnya: /tmp/gcsfuse-cache-path. ""
--client-protocol Menentukan protokol yang digunakan untuk berkomunikasi dengan backend Cloud Storage.
  • http1 untuk HTTP/1.1
  • http2 untuk HTTP/2
  • grpc untuk gRPC
 http1
--config-file Menentukan jalur ke file konfigurasi yang ingin Anda gunakan untuk mengonfigurasi perilaku Cloud Storage FUSE. Jalur, misalnya: /etc/gcsfuse.yaml. ""
--custom-endpoint 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 endpoint kustom tidak ditentukan, Cloud Storage FUSE akan menggunakan endpoint Cloud Storage JSON API global, 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. Endpoint, misalnya: http://localhost:443/storage/v1. ""
--debug_fuse (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. Nilai boolean: true, false. false jika --debug_fuse tidak ditentukan. true jika --debug_fuse ditentukan.
--debug_gcs (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. Nilai boolean: true, false. false jika --debug_gcs tidak ditentukan. true jika --debug_gcs ditentukan.
--debug_invariants Keluar dari program saat pelanggaran invarian internal terdeteksi. Nilai boolean: true, false. false
--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, debug, info, peringatan, dan error. Nilai boolean: true, false. false
--dir-mode Bit izin akses untuk direktori, dalam oktal. Bilangan bulat antara 000 dan 777 (inklusif). 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. Nilai boolean: true, false. false
--file-cache-cache-file-for-range-read Menentukan apakah objek lengkap harus didownload secara asinkron dan disimpan di direktori cache Cloud Storage FUSE saat pembacaan pertama selesai dari offset non-nol. Opsi ini harus disetel ke true jika Anda berencana melakukan beberapa pembacaan acak atau pembacaan sebagian.

Catatan: Jika Anda melakukan pembacaan sebagian yang dimulai dari offset 0, Cloud Storage FUSE akan mendownload dan meng-cache objek lengkap secara asinkron.

 Nilai boolean: true, false. false
--file-cache-download-chunk-size-mb Menentukan ukuran setiap permintaan baca dalam MiB yang dibuat oleh setiap goroutine ke Cloud Storage saat mendownload objek ke cache file. Bilangan bulat 50
--file-cache-enable-parallel-downloads

Mempercepat pembacaan file besar dengan menggunakan direktori cache file sebagai buffering pengambilan data menggunakan beberapa pekerja untuk mendownload file besar secara paralel. Untuk mempelajari download paralel lebih lanjut dan mengonfigurasi properti pendukungnya, lihat Meningkatkan performa baca menggunakan download paralel.

Untuk menggunakan download paralel, Anda harus mengaktifkan penyimpanan dalam cache file terlebih dahulu.

 Nilai boolean: true, false. false
--file-cache-max-parallel-downloads Jumlah maksimum goroutine yang dapat dibuat pada waktu tertentu di semua tugas download file.
  • Bilangan bulat
  • -1: Menentukan download paralel tanpa batas.
  • 0: Menonaktifkan download paralel. Hanya dapat digunakan jika --enable-parallel-downloads tidak diteruskan atau diteruskan sebagai false.
  • >0: Tidak menentukan batas atas. Cloud Storage FUSE secara internal membatasi nilai berdasarkan jumlah maksimum goroutine yang dapat dibuat berdasarkan konfigurasi mesin Anda.
 Dua kali jumlah core CPU di komputer Anda atau 16, mana saja yang lebih tinggi.
--file-mode Menentukan bit izin untuk file, dalam oktal. Bilangan bulat antara 000 dan 777 (inklusif). 644
--foreground Menjalankan perintah gcsfuse di latar depan. Nilai boolean: true, false. false
--gid Menentukan pemilik ID Grup (GID) dari semua inode.
  • Bilangan bulat yang mewakili GID.
  • -1: GID pemanggil digunakan.
 -1
--help Menampilkan bantuan tentang Cloud Storage FUSE. Tidak ada Tidak ada
--version Menampilkan versi Cloud Storage FUSE yang telah diinstal. Tidak ada Tidak ada
--http-client-timeout Menentukan durasi tunggu klien HTTP Cloud Storage FUSE untuk mendapatkan respons dari server sebelum waktu habis. Durasi, misalnya: 1h10m10s selama 1 jam, 10 menit, dan 10 detik. 0s menentukan tidak ada waktu tunggu. 0s
--ignore-interrupts 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. Nilai boolean: true, false. true
--implicit-dirs Secara implisit menyertakan folder dan folder terkelola. Lihat dokumentasi file dan direktori di GitHub untuk mengetahui informasi selengkapnya. Nilai boolean: true, false. false
--kernel-list-cache-ttl-secs 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.
  • Bilangan bulat yang mewakili detik, misalnya: 10 (10 detik).
  • 0: Menonaktifkan cache daftar.
  • -1: Melewati masa berlaku entri dan selalu menampilkan respons daftar dari cache jika tersedia.
 0
--key-file 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. Jalur, misalnya: /home/example_user/gcloud-key.json. Jika opsi ini tidak ditetapkan, Kredensial Default Aplikasi akan digunakan.
--limit-bytes-per-sec Menentukan batas bandwidth yang dapat digunakan Cloud Storage FUSE untuk membaca data dari Cloud Storage, yang diukur selama periode 30 detik. Angka floating point. -1 tidak menentukan batas. -1
--limit-ops-per-sec Menentukan batas untuk operasi yang dijalankan per detik, yang diukur selama periode 30 detik. Angka floating point. -1 tidak menentukan batas. -1
--log-file Menentukan file untuk menyimpan log yang dapat diurai oleh Fluentd. Jalur, misalnya: /tmp/user-example-bucket-gcsfuse-logs.txt. stdout saat Cloud Storage FUSE dijalankan di latar depan atau syslog saat Cloud Storage FUSE dijalankan di latar belakang
--log-format Menentukan format file log.
  • text
  • json
 json
--log-rotate-backup-file-count Jumlah maksimum file log yang dirotasi untuk dipertahankan, tidak termasuk file aktif tempat log ditulis.
  • Bilangan bulat
  • 0: Mempertahankan semua file log yang dirotasi
 10
--log-rotate-compress Menentukan apakah file log yang dirotasi dikompresi menggunakan gzip. Nilai boolean: true, false. true
--log-rotate-max-file-size-mb Ukuran maksimum dalam megabyte (MB) yang dapat dicapai file log sebelum dirotasi. Bilangan bulat. Nilai minimumnya adalah 1. 512
--log-severity

Tingkat keparahan yang Anda inginkan untuk dihasilkan log oleh Cloud Storage FUSE. Tingkat keparahan diurutkan dari tingkat keparahan terendah hingga tertinggi. Misalnya, saat Anda menentukan warning, Cloud Storage FUSE akan menghasilkan log untuk peringatan dan error. Secara umum, sebaiknya gunakan tingkat keparahan info.
  • trace
  • debug
  • info
  • warning
  • error
  • off: Menonaktifkan semua logging.
 info
--max-conns-per-host Menentukan jumlah maksimum koneksi TCP yang diizinkan per server. Hal ini mulai berlaku jika --client-protocol ditetapkan ke http1. Bilangan bulat antara 0 dan 2147483647. 0 tidak menentukan batas pada koneksi TCP. 0
--max-idle-conns-per-host Menentukan jumlah maksimum koneksi tidak ada aktivitas yang diizinkan per server. Hal ini mulai berlaku jika --client-protocol ditetapkan ke http1. Bilangan bulat antara 0 dan 2147483647. 0 tidak menentukan batas pada koneksi tidak ada aktivitas. 0
--max-retry-sleep Menentukan durasi maksimum yang diizinkan Cloud Storage FUSE untuk tidur dalam loop percobaan ulang dengan backoff eksponensial. Setelah durasi backoff melebihi durasi maksimum yang ditentukan, percobaan ulang akan dilanjutkan dengan durasi maksimum yang ditentukan. Durasi, misalnya: 1h5m50s (1 jam, 5 menit, dan 50 detik) atau 60s (60 detik). 30s
--metadata-cache-negative-ttl-secs

Menentukan time to live (TTL) dalam hitungan detik dari entri cache statistik negatif, yang menyimpan hasil untuk file yang tidak ada dalam cache.
  • Bilangan bulat yang mewakili detik, misalnya: 10 (10 detik).
  • 0: Menonaktifkan caching statistik negatif.
  • -1: Mengizinkan caching statistik negatif tanpa batas dan menonaktifkan masa berlaku TTL.
 5
--metadata-cache-ttl-secs Menentukan time to live (TTL) dalam detik dari entri metadata yang di-cache.
  • Bilangan bulat yang mewakili detik, misalnya: 30 (30 detik).
  • -1: Mengabaikan akhir masa berlaku TTL dan menayangkan file dari cache setiap kali tersedia.
  • 0: Menggunakan file terbaru. 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.
 60
-o 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 opsi -o. Opsi pemasangan di FUSE, misalnya:
  • rw: Memasang sebagai baca-tulis.
  • ro: Memasang sebagai hanya baca.
 ""
--only-dir Hanya memasang direktori tertentu dalam bucket. Jalur, misalnya: /etc/gcsfuse.yaml. ""
--rename-dir-limit Mengizinkan penggantian nama direktori yang berisi turunan yang lebih sedikit dari batas yang ditentukan. Bilangan bulat antara 0 dan 2147483647. 0
--retry-multiplier Menentukan pengganda untuk backoff eksponensial di antara percobaan ulang berturut-turut. Angka floating-point 2
--reuse-token-from-url Menentukan apakah akan menggunakan kembali token yang diperoleh dari --token-url. Nilai boolean: true, false. true
--sequential-read-size-mb Menentukan ukuran potongan data yang akan didownload dari Cloud Storage, dalam megabyte (MB). Bilangan bulat antara 1 dan 1024. 200
--stackdriver-export-interval Mengekspor metrik ke stackdriver dengan interval yang ditentukan. Durasi, misalnya: 1h5m50s (1 jam, 5 menit, dan 50 detik). 0s menentukan tidak ada ekspor. 0s
--stat-cache-capacity (tidak digunakan lagi) Menentukan jumlah entri yang dapat disimpan oleh cache statistik. Opsi ini telah diganti dengan opsi --stat-cache-max-size-mb. Bilangan bulat 4096
--stat-cache-max-size-mb Ukuran memori maksimum yang dapat digunakan cache statistik, dalam MiB. Cache statis selalu disimpan sepenuhnya dalam memori.
  • Bilangan bulat. Sebaiknya lakukan tindakan berikut:
    • 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.
  • -1: Tidak menetapkan batas, dengan cache statistik menggunakan memori sebanyak yang diperlukan.
  • 0: Menonaktifkan cache statistik.
 32
--stat-cache-ttl (tidak digunakan lagi) Menentukan durasi penyimpanan atribut StatObject dan atribut inode ke dalam cache. Opsi ini telah diganti dengan opsi --metadata-cache-ttl-secs. Durasi, misalnya: 20s (20 detik). 60s
--temp-dir Menentukan jalur ke direktori sementara tempat penulisan dirilis bertahap untuk pengujian sebelum diupload ke Cloud Storage. Jalur, misalnya: /mnt/ssd/example-user-gcsfuse-temp-dir. /tmp
--token-url Menentukan URL untuk mendapatkan token akses jika --key-file tidak ada. URL. ""
--type-cache-ttl (deprecated) Menentukan durasi penyimpanan pemetaan antara nama dan file atau direktori dalam cache di inode direktori, dalam hitungan detik. Opsi ini telah diganti dengan opsi --metadata-cache-ttl-secs. Durasi dalam detik, misalnya: 20s (20 detik). 60s
--type-cache-max-size-mb Ukuran maksimum dalam MiB per direktori yang dapat digunakan cache jenis. Cache jenis selalu disimpan sepenuhnya di memori.
  • Bilangan bulat. Sebaiknya lakukan tindakan berikut:
    • 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.
  • -1: Tidak menentukan batas dan memungkinkan cache jenis menggunakan memori sebanyak yang diperlukan.
  • 0: Menonaktifkan cache jenis.
 4
--uid Menentukan pemilik ID Pengguna (UID) semua inode.
  • Bilangan bulat yang mewakili UID.
  • -1: UID pemanggil digunakan.
 -1