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.

Ringkasan gcsfuse CLI

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

Struktur perintah opsi Cloud Storage FUSE CLI

Contoh berikut menunjukkan struktur perintah gcsfuse, termasuk argumen yang diperlukan dan opsi global opsional.

gcsfuse GLOBAL_OPTIONS BUCKET_NAME MOUNT_POINT

Dengan:

  • 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.

Opsi global

Opsi Deskripsi Nilai yang valid Nilai default
Menonaktifkan autentikasi untuk permintaan. Opsi ini harus disetel jika Anda menggunakan endpoint kustom yang tidak mendukung autentikasi. Opsi ini juga harus disetel jika Anda menggunakan Cloud Storage FUSE dengan bucket publik. Nilai boolean: true, false. false
Nama aplikasi pemasangan. Nilai string, misalnya: my-bucket-mount. ""
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 merepresentasikan project ID. ""

Mengaktifkan cache file dan menentukan direktori untuk menyimpan data cache file.

 Jalur, misalnya: /tmp/gcsfuse-cache-path. Nilai kosong menunjukkan bahwa opsi ini dinonaktifkan. Opsi ini dinonaktifkan secara default. ""
Menentukan protokol yang digunakan untuk berkomunikasi dengan backend Cloud Storage.
  • http1 untuk HTTP/1.1
  • http2 untuk HTTP/2
  • grpc untuk gRPC. Untuk menggunakan gRPC dengan Cloud Storage FUSE, sebaiknya gunakan Cloud Storage FUSE versi 2.10.0 atau yang lebih baru.
 http1

Mengekspor metrik ke Cloud Monitoring dengan interval yang ditentukan.

 Bilangan bulat yang mewakili nilai dalam detik, misalnya: 10 (10 detik). 0 menentukan tidak ada ekspor. 0
Menentukan jalur ke file konfigurasi yang ingin Anda gunakan untuk mengonfigurasi perilaku Cloud Storage FUSE. Jalur, misalnya: /etc/gcsfuse.yaml. ""
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 melewati autentikasi. Endpoint, misalnya: http://localhost:443/storage/v1. ""
Mengaktifkan output proses debug FUSE terkait. Opsi ini telah digantikan oleh 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
Mencetak informasi permintaan dan pengaturan waktu Cloud Storage. Opsi ini telah digantikan oleh 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
Menghentikan program saat pelanggaran invarian internal terdeteksi. Nilai boolean: true, false. false
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
Bit izin akses untuk direktori, dalam oktal. Bilangan bulat antara 000 dan 777 (inklusif). 755
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
Mengontrol alur jalur penulisan sehingga data diupload langsung ke Cloud Storage saat ditulis, bukan melakukan staging penulisan sepenuhnya secara lokal dan menguploadnya saat close() atau fsync(). Untuk mengetahui informasi selengkapnya tentang penulisan streaming, lihat dokumentasi GitHub Cloud Storage FUSE. Nilai boolean: true, false. true

Menentukan ukuran maksimum dalam MiB yang dapat digunakan cache file dan memungkinkan Anda membatasi total kapasitas yang dapat digunakan cache file dalam direktori yang di-mount.
  • Bilangan bulat
  • -1: Menentukan penggunaan seluruh kapasitas yang tersedia di cache dalam direktori yang Anda tentukan untuk cache-dir. Ini adalah default hanya jika cache-dir diteruskan.
  • 0: Menonaktifkan cache file.
 -1
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. Nilai boolean: true, false. false
Menentukan ukuran setiap permintaan baca dalam MiB yang dilakukan setiap goroutine ke Cloud Storage saat mendownload objek ke dalam cache file. Bilangan bulat 200

Mempercepat pembacaan file besar dengan menggunakan direktori cache file sebagai buffer pengambilan data menggunakan beberapa pekerja untuk mendownload beberapa bagian file secara paralel.

Download paralel diaktifkan secara otomatis saat Anda mengaktifkan penyimpanan file dalam cache. Untuk mempelajari lebih lanjut penyiapan cache file, lihat Menggunakan penyiapan cache file Cloud Storage FUSE.

Untuk mempelajari lebih lanjut download paralel dan cara mengonfigurasi properti pendukung, lihat Download paralel.

 Nilai boolean: true, false. true
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 di-spawn yang ditentukan oleh konfigurasi mesin Anda.
 Dua kali jumlah inti CPU di mesin Anda atau 16, mana saja yang lebih tinggi.
Jumlah permintaan download serentak per file. Bilangan bulat 16
Menentukan bit izin untuk file, dalam oktal. Bilangan bulat antara 000 dan 777 (inklusif). 644
Menjalankan perintah gcsfuse di latar depan. Nilai boolean: true, false. false
Menentukan pemilik ID Grup (GID) dari semua inode.
  • Bilangan bulat yang merepresentasikan GID.
  • -1: GID pemanggil digunakan.
 -1
Menampilkan bantuan tentang Cloud Storage FUSE. Tidak ada Tidak ada
Menampilkan versi Cloud Storage FUSE yang telah diinstal. Tidak ada Tidak ada
Menentukan durasi tunggu klien HTTP Cloud Storage FUSE untuk mendapatkan respons dari server sebelum waktu habis. Durasi, misalnya: 1h10m10s untuk 1 jam, 10 menit, dan 10 detik. 0s tidak menentukan waktu tunggu. 0s
Menginstruksikan 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
Secara implisit menyertakan folder dan folder terkelola. Lihat dokumentasi file dan direktori di GitHub untuk mengetahui informasi selengkapnya. Nilai boolean: true, false. false
Mengaktifkan cache daftar dan menentukan time to live (TTL) dalam hitungan detik untuk entri daftar yang di-cache. Cache daftar disimpan di memori dalam cache halaman, yang dikontrol oleh kernel berdasarkan memori yang tersedia.
  • Bilangan bulat yang mewakili detik, misalnya: 10 (10 detik).
  • 0: Menonaktifkan caching daftar.
  • -1: Melewati masa berlaku entri dan selalu menampilkan respons daftar dari cache saat tersedia.
 0
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 disetel, Kredensial Default Aplikasi akan digunakan.
Menentukan batas bandwidth yang dapat digunakan Cloud Storage FUSE untuk membaca data dari Cloud Storage, yang diukur selama periode 30 detik. Ditulis dalam bilangan floating point. -1 tidak menentukan batas. -1
Menentukan batas untuk operasi yang dijalankan per detik, yang diukur selama periode 30 detik. Ditulis dalam bilangan floating point. -1 tidak menentukan batas. -1
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
Menentukan format file log.
  • text
  • json
 json
Jumlah maksimum file log yang dirotasi untuk dipertahankan, tidak termasuk file aktif yang digunakan untuk menulis log.
  • Bilangan bulat
  • 0: Mempertahankan semua file log yang dirotasi
 10
Menentukan apakah file log yang dirotasi dikompresi menggunakan gzip. Nilai boolean: true, false. true
Ukuran maksimum dalam megabyte (MB) yang dapat dicapai file log sebelum dirotasi. Bilangan bulat. Nilai minimum adalah 1. 512

Tingkat keparahan yang Anda inginkan untuk dihasilkan lognya 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
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
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 untuk koneksi yang tidak aktif. 0
Menentukan durasi maksimum yang diizinkan untuk Cloud Storage FUSE dalam mode tidur di loop percobaan ulang dengan backoff eksponensial. Setelah durasi backoff melebihi durasi maksimum yang ditentukan, percobaan ulang akan berlanjut dengan durasi maksimum yang ditentukan. Durasi, misalnya: 1h5m50s (1 jam, 5 menit, dan 50 detik) atau 60s (60 detik). 30s

Menentukan time to live (TTL) dalam hitungan detik untuk 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
Menentukan time to live (TTL) dalam detik untuk entri metadata yang di-cache.
  • Bilangan bulat yang mewakili detik, misalnya: 30 (30 detik).
  • -1: Melewati akhir masa berlaku TTL dan menyajikan file dari cache kapan pun file tersebut tersedia.
  • 0: Gunakan file terbaru. Menggunakan nilai ini akan mengeluarkan panggilan metadata Get untuk memastikan bahwa generasi objek untuk file dalam cache cocok dengan yang disimpan di Cloud Storage. Untuk mempelajari lebih lanjut, lihat Mengonfigurasi pembatalan cache.
 60
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: Dipasang sebagai baca-tulis.
  • ro: Pasang sebagai hanya baca.
 ""
Hanya memasang direktori tertentu dalam bucket. Jalur, misalnya: /etc/gcsfuse.yaml. ""

Mengekspos endpoint metrik Prometheus di port dan jalur /metrics yang ditentukan.

 Bilangan bulat yang merepresentasikan port yang ingin Anda tentukan. 0
Mengizinkan penggantian nama direktori yang berisi turunan yang lebih sedikit dari batas yang ditentukan. Bilangan bulat antara 0 dan 2147483647. 0
Menentukan pengganda untuk backoff eksponensial antara percobaan ulang berturut-turut. Angka floating-point 2
Menentukan apakah akan menggunakan kembali token yang diperoleh dari --token-url. Nilai boolean: true, false. true
Menentukan ukuran potongan data yang akan didownload dari Cloud Storage, dalam megabyte (MB). Bilangan bulat antara 1 dan 1024. 200
Menentukan jumlah entri yang dapat disimpan oleh cache statistik. Opsi ini telah digantikan dengan opsi --stat-cache-max-size-mb. Bilangan bulat 4096
Ukuran memori maksimum yang dapat digunakan oleh cache statistik, dalam MiB. Cache statistik selalu disimpan sepenuhnya dalam memori.
  • Bilangan bulat. Sebaiknya lakukan tindakan berikut:
    • 32 jika workload 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 stat 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
Menentukan durasi penyimpanan hasil StatObject dan atribut inode ke dalam cache. Opsi ini telah digantikan oleh opsi --metadata-cache-ttl-secs. Durasi, misalnya: 20s (20 detik). 60s
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
Menentukan URL untuk mendapatkan token akses jika --key-file tidak ada. URL. ""
Menentukan durasi penyimpanan pemetaan antara nama dan file atau direktori dalam cache di inode direktori, dalam detik. Opsi ini telah digantikan dengan opsi --metadata-cache-ttl-secs. Durasi dalam detik, misalnya: 20s (20 detik). 60s
Ukuran maksimum dalam MiB per direktori yang dapat digunakan oleh cache jenis. Cache jenis selalu disimpan sepenuhnya dalam 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 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
Menentukan pemilik ID Pengguna (UID) semua inode.
  • Bilangan bulat yang merepresentasikan UID.
  • -1: UID pemanggil digunakan.
 -1

Menentukan jumlah maksimum potongan data yang tersedia untuk penulisan streaming di semua file. Setiap file menggunakan satu potongan data 32 MiB secara default.
  • Bilangan bulat
  • 0: menonaktifkan penulisan streaming.
  • -1: menetapkan nilai ke potongan tidak terbatas.
  • Nilai default untuk mesin spesifikasi rendah dengan resource terbatas: 4
  • Nilai default untuk mesin spesifikasi tinggi dengan sejumlah besar resource: 1600

Kembali ke atas