Object Storage Service:Opsi pemasangan

Format perintah

./ossfs -h

Anda dapat menjalankan perintah ini dari direktori yang berisi file eksekusi ossfs. Direktori default adalah /usr/local/bin/. Gunakan jalur instalasi aktual di lingkungan Anda.

Opsi umum

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

ossfs bucket_name mount_point -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

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

ossfs bucket_name mount_point -omax_stat_cache_size=0

ossfs bucket_name mount_point -ourl=endpoint -oallow_other

ossfs bucket_name mount_point -odbglevel=info

ossfs bucket_name mount_point -f

ossfs bucket_name mount_point -d

Daftar opsi

Dalam kebanyakan kasus, format opsi adalah -ooption_name=option_value atau -o option_name=option_value.

• Opsi ossfs

  Option Name	Description
  retries	Menentukan jumlah percobaan ulang setelah permintaan gagal. Nilai default adalah 2.
  storage_class	Menentukan kelas penyimpanan untuk file yang ditulis ke OSS. Nilai yang valid adalah: Standard (default): Standard IA: Infrequent Access Archive: Archive Storage Untuk informasi lebih lanjut tentang kelas penyimpanan, lihat Storage classes.
  public_bucket	Menentukan apakah akan mengakses bucket secara anonim. Opsi ini hanya berlaku untuk bucket yang daftar kontrol akses (ACL)-nya bersifat public-read-write. Nilai yang valid adalah: 0 (default): Jangan mengakses bucket secara anonim. 1: Akses bucket secara anonim.
  passwd_file	Menentukan file yang menyimpan pasangan AccessKey untuk bucket. File default adalah /etc/passwd-ossfs.
  connect_timeout	Menentukan periode timeout koneksi dalam detik. Nilai default adalah 300 detik.
  readwrite_timeout	Menentukan periode timeout untuk permintaan baca atau tulis dalam detik. Nilai default adalah 120 detik.
  max_stat_cache_size	Menentukan jumlah entri metadata file yang di-cache. Nilai default adalah 100.000, yang mengonsumsi sekitar 40 MB ruang tambahan.
  readdir_optimize	Mengontrol apakah akan menggunakan caching untuk mengoptimalkan performa. Secara default, opsi ini dinonaktifkan. Saat Anda mengaktifkan opsi ini, ossfs tidak mengirim permintaan HeadObject untuk mengambil metadata file seperti gid dan uid selama operasi ls. ossfs hanya mengirim permintaan HeadObject jika ukuran file adalah 0. Namun, beberapa permintaan HeadObject mungkin tetap terjadi karena alasan seperti pemeriksaan izin. Pilih opsi ini berdasarkan atribut aplikasi Anda. Untuk mengaktifkannya, tambahkan -oreaddir_optimize saat memasang bucket.
  stat_cache_expire	Menentukan waktu kedaluwarsa untuk cache metadata file dalam detik. Nilai default adalah 900 detik.
  no_check_certificate	Menonaktifkan verifikasi sertifikat sisi server. Opsi ini hanya berlaku 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	Menentukan jumlah maksimum permintaan konkuren untuk mengakses metadata file saat mencantumkan file. Nilai default adalah 20.
  parallel_count	Menentukan jumlah bagian konkuren saat mengunggah file besar dalam mode unggah multi-bagian. Nilai default adalah 5.
  multipart_size	Menentukan ukuran setiap bagian dalam MB untuk unggah multi-bagian. Nilai default adalah 10. Parameter ini memengaruhi ukuran file maksimum yang didukung. Jumlah maksimum bagian untuk unggah multi-bagian adalah 10.000. Dengan nilai default, ukuran file maksimum yang didukung adalah 100 GB. Untuk mendukung file yang lebih besar, sesuaikan nilai ini sesuai kebutuhan.
  url	Menentukan endpoint bucket.
  umask	Mengatur mask izin untuk file dan folder di titik pemasangan. Sebagai contoh, untuk mengatur izin file dan folder di titik pemasangan menjadi 770, tambahkan -oumask=007. Untuk mengatur izin menjadi 700, tambahkan -oumask=077. Catatan Versi 1.91.*: Izin default untuk file adalah 0640, dan izin default untuk folder adalah 0750. Versi 1.80.*: Izin default untuk file dan folder adalah 0777.
  enable_content_md5	Menentukan apakah akan mengatur CONTENT_MD5 selama operasi unggah. Secara default, ini tidak diatur. Untuk mengatur Content-MD5, tambahkan opsi -oenable_content_md5.
  ram_role	Menggunakan RAM role untuk mengakses OSS. Saat Anda menggunakan metode ini 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 tipe direktori yang tidak kompatibel. Secara default, ossfs mengenali dir/, dir, dan dir_$folder$ sebagai direktori. Untuk membatasi ossfs agar hanya mengenali dir/ sebagai direktori dan mengurangi interaksi antara ossfs dan server, gunakan opsi -onotsup_compat_dir.
  direct_read	Mengaktifkan pembacaan data langsung dari OSS tanpa menyimpannya di cache ke disk lokal. Secara default, ossfs menggunakan direktori sementara lokal. Untuk mengaktifkan mode ini, gunakan -odirect_read. Catatan Jika operasi tulis, rename, atau truncate terdeteksi pada file selama pembacaan langsung, file tersebut keluar dari mode pembacaan langsung hingga dibuka kembali.
  direct_read_chunk_size	Dalam mode pembacaan langsung, menentukan jumlah data yang dibaca dari OSS dalam satu permintaan baca. Satuannya adalah MB. Nilai default adalah 4. Nilainya berkisar antara 1 hingga 32. Opsi ini hanya berlaku ketika -odirect_read diaktifkan.
  direct_read_prefetch_thread	Dalam mode pembacaan langsung, ossfs melakukan pra-baca sebagai tugas asinkron latar belakang. Opsi ini menentukan jumlah maksimum thread untuk permintaan pra-ambil secara bersamaan. Nilai default adalah 64. Opsi ini hanya berlaku ketika -odirect_read diaktifkan.
  direct_read_prefetch_chunks	Dalam mode pembacaan langsung, menentukan jumlah chunk yang dipra-ambil ke memori. Ini meningkatkan performa ossfs dalam skenario baca berurutan. Nilai default adalah 32. Opsi ini hanya berlaku ketika -odirect_read diaktifkan.
  direct_read_prefetch_limit	Dalam mode pembacaan langsung, ossfs menggunakan memori untuk menyimpan data yang dipra-ambil dari OSS. Opsi ini membatasi jumlah total data yang dapat dipra-ambil oleh ossfs. Satuannya adalah MB. Nilai default adalah 1024. Opsi ini hanya berlaku ketika -odirect_read diaktifkan.
  dbglevel	Mengatur tingkat log. Tingkat log yang didukung adalah sebagai berikut: critical error (default) warn info debug
  logfile	Menentukan jalur file log. Jika Anda tidak menentukan opsi ini, log ditulis ke log sistem. Pada CentOS, log sistem disimpan ke /var/log/messages secara default. Pada Ubuntu, log sistem disimpan ke /var/log/syslog secara default. Penting Log tidak diputar otomatis setelah Anda menentukan jalur file log. Pantau penggunaan disk space untuk file log.
  curldbg	Mengaktifkan logging libcurl. Secara default, ini dinonaktifkan. Untuk mengoutput log libcurl, tambahkan opsi -ocurldbg.

• Opsi cache data

  Catatan

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

  Option Name	Description
  use_cache	Mengaktifkan caching data dan menentukan jalur cache data. Secara default, fitur ini dinonaktifkan. Tentukan opsi ini untuk mengonfigurasi jalur cache. Sebagai contoh, Anda dapat menambahkan -ouse_cache=path selama pemasangan untuk mengaktifkan caching data dan menentukan jalur cache data sebagai path. Ganti path dengan jalur aktual, seperti /tmp/your_foldername.
  ensure_diskfree	Mengontrol jumlah ruang disk yang dicadangkan. Secara default, tidak ada ruang yang dicadangkan. Gunakan opsi ini untuk mengatur jumlah ruang disk kosong yang dicadangkan dalam MB. Ini mencegah disk menjadi penuh dan memengaruhi aplikasi lain. Sebagai contoh, untuk memastikan setidaknya tersedia 1024 MB ruang disk kosong, tambahkan -oensure_diskfree=1024 selama pemasangan.
  del_cache	Mengontrol penghapusan cache lokal. Secara default, cache tidak dihapus. Atur opsi ini untuk mengonfigurasi ossfs agar membersihkan cache data lokal. Sebagai contoh, jika Anda menambahkan opsi -odel_cache, ossfs membersihkan file cache di folder yang ditentukan oleh use_cache selama operasi mount dan umount.
  max_dirty_data	Ketika ukuran file yang sedang ditulis melebihi nilai ini, file sementara antara diunggah sebelum file ditutup. Nilai default adalah 5120 MB. Sebagai contoh, untuk mengunggah file ketika ukurannya melebihi 2000 MB, tambahkan -omax_dirty_data=2000 selama pemasangan. Jika Anda mengaktifkan pengendalian versi untuk OSS, menulis file besar dapat menghasilkan file antara untuk beberapa versi. Atur opsi ini ke nilai yang besar.
  tmpdir	Secara default, data disimpan sementara di direktori /tmp pada disk sistem. Tentukan opsi ini untuk mengonfigurasi jalur cache sementara default. Opsi ini tidak dapat digunakan bersamaan dengan opsi use_cache. Sebagai contoh, tambahkan -otmpdir=path selama pemasangan untuk mengatur jalur cache data sementara default menjadi path. Atur path ke jalur aktual, seperti /data/your_foldername.
  free_space_ratio	Mengontrol persentase minimum ruang disk kosong yang harus dipertahankan setelah caching. Sebagai contoh, jika disk space adalah 50 GB dan Anda mengatur opsi ini menjadi -ofree_space_ratio=20, ruang 10 GB (50 GB × 20%) dicadangkan.
  disable_noobj_cache	Opsi ini ditambahkan di ossfs 1.91.6. Opsi ini menonaktifkan atau mengaktifkan caching metadata noobj. Jika diaktifkan, informasi di-cache bahkan jika file tidak ada. Nilai default adalah false (diaktifkan). Sebagai contoh, tambahkan -o disable_noobj_cache selama pemasangan untuk menonaktifkan caching metadata noobj. Di ossfs 1.91.6 dan versi yang lebih baru, caching noobj digunakan secara default. Untuk menonaktifkannya, tambahkan opsi ini.

• Opsi FUSE

  Option name	Description
  allow_other	Memodifikasi izin titik pemasangan agar semua pengguna dapat mengakses direktori pemasangan. Ini tidak mencakup file di dalam direktori tersebut. Anda harus mengatur izin untuk file di dalam direktori secara terpisah. Untuk memodifikasi izin file tertentu, gunakan perintah chmod. Untuk mengatur izin yang sama untuk semua file, konfigurasikan opsi umask. Secara default, hanya pengguna root yang dapat mengatur opsi -oallow_other. Opsi ini tidak memiliki nilai. Untuk menggunakannya, cukup tambahkan opsi -oallow_other.
  uid	Menentukan user ID (UID) pengguna yang memiliki folder tersebut.
  gid	Menentukan group ID (GID) pengguna yang memiliki folder tersebut.