Object Storage Service：Opsi Mount

Format Perintah

./ossfs -h

Jalankan perintah ini dari direktori yang berisi program ossfs. Direktori defaultnya adalah /usr/local/bin/, tetapi jalur sebenarnya mungkin berbeda tergantung pada lingkungan instalasi Anda.

Opsi Umum

-o option_name[=option_value]  atau  -ooption_name[=option_value]

ossfs nama_bucket titik_pemasangan -ourl=endpoint -ouid=uid -ogid=gid

-ourl=oss-cn-hangzhou.aliyuncs.com
-ourl=http://oss-cn-hangzhou.aliyuncs.com
-ourl=https://oss-cn-hangzhou.aliyuncs.com

# Tulis kunci ke file /etc/passwd-ossfs dan atur izin menjadi 640
echo bucket-test:yourAccessKeyID:yourAccessKeySecret > /etc/passwd-ossfs
chmod 640 /etc/passwd-ossfs

# Tulis kunci ke file /passwd-path/passwd-ossfs dan atur izin menjadi 600
echo bucket-test:yourAccessKeyID:yourAccessKeySecret > /passwd-path/passwd-ossfs
chmod 600 /passwd-path/passwd-ossfs

# Tentukan variabel opasswd_file dan atur nilainya menjadi /passwd-path/passwd-ossfs
-opasswd_file=/passwd-path/passwd-ossfs

ossfs nama_bucket titik_pemasangan -omax_stat_cache_size=0

ossfs nama_bucket titik_pemasangan -ourl=endpoint -oallow_other

ossfs nama_bucket titik_pemasangan -odbglevel=info

ossfs nama_bucket titik_pemasangan -f

ossfs nama_bucket titik_pemasangan -d

Daftar Opsi

Secara umum, format opsi adalah -ooption_name=option_value atau -o option_name=option_value.

• opsi ossfs

  Nama Opsi	Deskripsi
  retries	Menentukan jumlah percobaan ulang setelah permintaan gagal. Nilai default: 2.
  storage_class	Menentukan kelas penyimpanan untuk file yang ditulis ke OSS. Nilai valid: Standard (default): Standar IA: Akses Jarang Archive: Penyimpanan Arsip Untuk informasi lebih lanjut, lihat Kelas Penyimpanan.
  public_bucket	Menentukan apakah akan mengakses bucket secara anonim. Opsi ini hanya valid untuk bucket dengan ACL baca-tulis publik. Nilai valid: 0 (default): Jangan akses bucket secara anonim. 1: Akses bucket secara anonim.
  passwd_file	Menentukan file yang menyimpan Pasangan Kunci Akses untuk bucket. File default: /etc/passwd-ossfs.
  connect_timeout	Menentukan periode waktu habis untuk koneksi. Satuan: detik. Nilai default: 300.
  readwrite_timeout	Menentukan periode waktu habis untuk permintaan baca atau tulis. Satuan: detik. Nilai default: 120.
  max_stat_cache_size	Menentukan jumlah entri metadata file yang akan di-cache. Nilai defaultnya adalah 100.000, yang mengonsumsi sekitar 40 MB ruang tambahan.
  readdir_optimize	Mengontrol apakah akan menggunakan optimasi cache. Secara default, fitur ini dinonaktifkan. Saat Anda menambahkan opsi pemasangan ini, ossfs tidak mengirim permintaan HeadObject untuk mendapatkan metadata file seperti gid dan uid selama operasi `ls`. Permintaan HeadObject hanya dikirim ketika ukuran file yang diakses adalah 0. Namun, sejumlah permintaan HeadObject tertentu masih mungkin dihasilkan karena pemeriksaan izin dan alasan lainnya. Pilih parameter ini berdasarkan atribut aplikasi Anda. Untuk mengaktifkan fitur ini, tambahkan -oreaddir_optimize saat Anda memasang bucket.
  stat_cache_expire	Menentukan waktu kedaluwarsa untuk cache metadata file. Satuan: detik. Nilai default: 900.
  no_check_certificate	Menonaktifkan verifikasi sertifikat server. Opsi ini hanya valid saat Anda menggunakan protokol HTTPS. Secara default, verifikasi sertifikat diaktifkan. Opsi ini tidak memiliki nilai. Untuk menggunakannya, cukup tambahkan opsi -ono_check_certificate.
  multireq_max	Jumlah maksimum permintaan bersamaan untuk mengakses metadata file saat mencantumkan file. Nilai default: 20.
  parallel_count	Jumlah shard bersamaan saat mengunggah file besar dalam mode unggah multi-bagian. Nilai default: 5.
  multipart_size	Ukuran setiap bagian untuk unggah multi-bagian. Satuan: MB. Nilai default: 10. Parameter ini memengaruhi ukuran maksimum file yang dapat diunggah. Dalam mode unggah multi-bagian, jumlah maksimum bagian adalah 10.000. Dengan nilai default, ukuran file maksimum adalah 100 GB. Untuk mendukung file yang lebih besar, sesuaikan nilai ini sesuai kebutuhan.
  url	Menentukan endpoint dari bucket.
  umask	Menetapkan masker izin untuk file dan folder di titik pemasangan. Sebagai contoh, untuk menetapkan izin untuk file dan folder di titik pemasangan menjadi 770, tambahkan -oumask=007. Untuk menetapkan izin menjadi 700, tambahkan -oumask=077. Catatan Versi ossfs 1.91.*: Izin default untuk file adalah 0640, dan izin default untuk folder adalah 0750. Versi ossfs 1.80.*: Izin default untuk file dan folder adalah 0777.
  enable_content_md5	Menentukan apakah akan menetapkan CONTENT_MD5 selama operasi unggah. Secara default, ini tidak disetel. Untuk menetapkan Content-MD5, tambahkan opsi -oenable_content_md5.
  ram_role	Menggunakan peran RAM untuk mengakses OSS. Saat metode ini digunakan untuk mengakses OSS, ID AccessKey dan rahasia AccessKey dalam file kunci diabaikan.
  listobjectsv2	Jika Pengendalian versi diaktifkan untuk bucket, gunakan opsi -olistobjectsv2 untuk mencantumkan file.
  notsup_compat_dir	Membatasi ketidakcocokan dengan beberapa jenis direktori. Secara default, ossfs mengenali dir/, dir, dan dir_$folder$ sebagai direktori. Untuk membatasi ossfs agar hanya mengenali dir/ sebagai direktori untuk mengurangi interaksi antara ossfs dan server, gunakan opsi -onotsup_compat_dir.
  ensure_diskfree	Menetapkan jumlah ruang disk yang tersedia untuk dicadangkan untuk ossfs. Untuk meningkatkan kinerja, ossfs menggunakan ruang disk untuk menyimpan data sementara untuk unggah atau unduhan secara default. Anda dapat menggunakan opsi ini untuk menetapkan jumlah ruang disk yang tersedia untuk dicadangkan. Satuan: MB. Sebagai contoh, untuk mencadangkan 1024 MB ruang disk yang tersedia untuk ossfs, gunakan -oensure_diskfree=1024.
  direct_read	Secara default, ossfs menggunakan ruang disk untuk menyimpan data sementara untuk unggah atau unduhan. Tetapkan opsi ini untuk membaca data langsung dari OSS tanpa menggunakan ruang disk lokal. Opsi ini tidak disetel secara default. Gunakan -odirect_read untuk mengaktifkan mode pembacaan langsung. Catatan Saat operasi `write`, `rename`, atau `truncate` terdeteksi pada file dalam mode pembacaan langsung, file keluar dari mode pembacaan langsung sampai dibuka kembali.
  direct_read_chunk_size	Dalam mode pembacaan langsung, menentukan jumlah data yang dibaca dari OSS dalam satu permintaan baca. Satuan: MB. Nilai default: 4. Rentang nilai: 1 hingga 32. Opsi ini berlaku hanya jika mode pembacaan langsung diaktifkan, yaitu, saat opsi -odirect_read digunakan.
  direct_read_prefetch_thread	Dalam mode pembacaan langsung, ossfs melakukan pra-baca sebagai tugas asinkron latar belakang. Opsi ini menentukan jumlah maksimum utas untuk permintaan pra-baca bersamaan. Nilai default: 64. Opsi ini berlaku hanya jika mode pembacaan langsung diaktifkan, yaitu, saat opsi -odirect_read digunakan.
  direct_read_prefetch_chunks	Dalam mode pembacaan langsung, menentukan jumlah chunk yang akan dibaca ke dalam memori. Ini meningkatkan kinerja ossfs dalam skenario pembacaan berurutan. Nilai default: 32. Opsi ini berlaku hanya jika mode pembacaan langsung diaktifkan, yaitu, saat opsi -odirect_read digunakan.
  direct_read_prefetch_limit	Dalam mode pembacaan langsung, ossfs menggunakan memori untuk menyimpan data pra-baca dari OSS. Opsi ini membatasi jumlah total data yang dapat dipra-baca oleh ossfs. Satuan: MB. Nilai default: 1024. Opsi ini berlaku hanya jika mode pembacaan langsung diaktifkan, yaitu, saat opsi -odirect_read digunakan.
  dbglevel	Menetapkan tingkat log. Tingkat log berikut didukung: critical (default) error warn info debug
  curldbg	Mengaktifkan informasi log libcurl. Secara default, ini dinonaktifkan. Untuk mengeluarkan log libcurl, tambahkan opsi -ocurldbg.

• Opsi cache data

  Catatan

  Untuk informasi lebih lanjut tentang prinsip caching data, lihat Caching Data.

  Nama Opsi	Deskripsi
  use_cache	Mengaktifkan caching data dan menentukan jalur cache data. Secara default, fitur ini dinonaktifkan. Anda dapat menentukan opsi ini untuk mengonfigurasi jalur cache. Sebagai contoh, Anda dapat menambahkan -ouse_cache=path selama pemasangan. Ini mengaktifkan caching data dan menetapkan jalur cache data ke path. Ganti path dengan jalur sebenarnya, seperti /tmp/your_foldername.
  ensure_diskfree	Mengontrol jumlah ruang disk yang dicadangkan. Secara default, tidak ada ruang yang dicadangkan. Anda dapat menggunakan opsi ini untuk menetapkan jumlah ruang disk yang tersedia untuk dicadangkan untuk mencegah disk penuh dan memengaruhi aplikasi lain. Satuan: MB. Sebagai contoh, untuk mencadangkan 1024 MB ruang disk yang tersedia untuk ossfs, tambahkan -oensure_diskfree=1024 selama pemasangan.
  del_cache	Mengontrol penghapusancache lokal. Secara default, cache tidak dihapus. Anda dapat menyetel opsi ini untuk mengonfigurasi ossfs agar membersihkan cache data lokal. Sebagai contoh, Anda dapat menambahkan opsi -odel_cache selama pemasangan. ossfs kemudian akan membersihkan file cache di folder yang ditentukan oleh use_cache selama operasi mount dan umount.
  max_dirty_data	Saat ukuran file yang sedang ditulis melebihi nilai ini, file sementara antara akan diunggah sebelum file ditutup. Nilai defaultnya adalah 5120 MB. Sebagai contoh, untuk mengunggah file secara dini saat ukurannya melebihi 2000 MB, tambahkan -omax_dirty_data=2000 selama pemasangan. Jika Anda mengaktifkan Pengendalian versi OSS, penulisan file besar mungkin menghasilkan beberapa versi file antara. Atur parameter ini ke nilai yang lebih besar.
  tmpdir	Secara default, data sementara di-cache di direktori /tmp disk sistem. Anda dapat menentukan opsi ini untuk mengonfigurasi jalur cache sementara default. Opsi ini tidak dapat digunakan bersamaan dengan opsi use_cache. Sebagai contoh, Anda dapat menambahkan -otmpdir=path selama pemasangan untuk menetapkan jalur cache data sementara default ke path. Ganti path dengan jalur sebenarnya, seperti /data/your_foldername.
  free_space_ratio	Mengontrol persentase minimum ruang disk yang tersisa setelah caching. Sebagai contoh, jika ruang disk adalah 50 GB dan Anda mengonfigurasi -ofree_space_ratio=20, maka 10 GB (50 GB × 20%) ruang dicadangkan.
  disable_noobj_cache	Opsi ini ditambahkan di ossfs 1.91.6. Ini menonaktifkan atau mengaktifkan caching metadata noobj. Artinya, informasi di-cache meskipun file tidak ada. Nilai defaultnya adalah false (diaktifkan). Sebagai contoh, Anda dapat menambahkan -o disable_noobj_cache selama pemasangan untuk menonaktifkan caching metadata noobj. Di ossfs 1.91.6 dan yang lebih baru, caching noobj digunakan secara default. Untuk menonaktifkannya, tambahkan opsi ini.

• Opsi FUSE

  Nama Opsi	Deskripsi
  allow_other	Mengubah izin titik pemasangan. Ini memungkinkan semua pengguna mengakses direktori pemasangan, tetapi tidak file di dalamnya. Atur izin untuk file di direktori secara terpisah. Untuk mengubah izin file individu, gunakan perintah chmod. Untuk menetapkan izin yang sama untuk semua file, gunakan opsi umask. Secara default, hanya pengguna root yang dapat menetapkan opsi -oallow_other. Opsi ini tidak memiliki nilai. Untuk menggunakannya, cukup tambahkan opsi -oallow_other.
  uid	Menentukan ID pengguna (UID) dari pemilik folder.
  gid	Menentukan ID grup (GID) dari pemilik folder.