Object Storage Service:Opsi mount untuk ossfs 2.0

Kategori

Item konfigurasi

Wajib

Deskripsi

Nilai default

Versi yang didukung

Konfigurasi dasar bucket

oss_endpoint

Ya

Titik akhir untuk mengakses bucket.

Tidak ada

v2.0.0 dan seterusnya

oss_bucket

Ya

Nama bucket.

Tidak ada

v2.0.0 dan seterusnya

Konfigurasi kredensial akses

oss_access_key_id

Bersyarat wajib

ID AccessKey. Diperlukan untuk autentikasi AccessKey.

Tidak ada

v2.0.0 dan seterusnya

oss_access_key_secret

Bersyarat wajib

Rahasia AccessKey. Diperlukan untuk autentikasi AccessKey.

Tidak ada

v2.0.0 dan seterusnya

ram_role

Bersyarat wajib

Peran RAM ECS. Diperlukan untuk autentikasi peran RAM ECS.

Tidak ada

v2.0.2 dan seterusnya

credential_process

Bersyarat wajib

Perintah untuk menjalankan proses eksternal guna memperoleh kredensial akses.

Diperlukan untuk autentikasi proses eksternal.

Tidak ada

v2.0.5 dan seterusnya

Kategori

Item konfigurasi

Wajib

Deskripsi

Nilai default

Versi yang didukung

Konfigurasi bucket

oss_bucket_prefix

Tidak

Memount folder tertentu di dalam bucket.

Kosong

v2.0.0 dan seterusnya

oss_region

Tidak

ID wilayah bucket, digunakan untuk algoritma signature OSS V4. Jika tidak ditentukan, akan menggunakan V1.

Kosong

v2.0.0 dan seterusnya

Konfigurasi cache

attr_timeout

Tidak

Waktu hidup (TTL) cache metadata file, dalam detik.

60

v2.0.0 dan seterusnya

negative_timeout

Tidak

TTL cache entri direktori tidak valid, dalam detik.

0

v2.0.0 dan seterusnya

readdirplus

Tidak

Mengaktifkan readdirplus. Membangun cache metadata file secara sinkron selama readdir, dengan biaya penggunaan memori yang lebih tinggi.

true

v2.0.0 dan seterusnya

disk_data_cache_dir

Ya

Jalur direktori cache lokal. Menetapkan nilai non-kosong akan mengaktifkan caching data. Untuk informasi selengkapnya, lihat Local data cache.

Kosong

v2.0.8 dan seterusnya

disk_data_cache_size

Ya

Kapasitas cache maksimum, diselaraskan ke GiB. Tidak boleh melebihi ruang yang tersedia pada disk atau partisi tempat direktori cache berada.

Kosong

v2.0.8 dan seterusnya

disk_data_cache_io_engine

Tidak

Mesin I/O untuk cache disk. Nilai yang valid: psync dan libaio.

psync

v2.0.8 dan seterusnya

Konfigurasi log

log_level

Tidak

Tingkat log. Nilai yang valid adalah info dan debug.

info

v2.0.0 dan seterusnya

log_dir

Tidak

Folder tempat file log disimpan.

/tmp/ossfs2

v2.0.0 dan seterusnya

log_file_max_size

Tidak

Ukuran maksimum satu file log, dalam byte.

67108864

v2.0.3 dan seterusnya

log_file_max_count

Tidak

Jumlah maksimum file log yang disimpan.

8

v2.0.3 dan seterusnya

Mode operasi

f

Tidak

Menjalankan ossfs di foreground.

false

v2.0.0 dan seterusnya

d

Tidak

Menjalankan ossfs di foreground dengan log debug FUSE diaktifkan.

false

v2.0.0 dan seterusnya

Mode mount

ro

Tidak

Memount sistem file dalam mode read-only.

false

v2.0.0 dan seterusnya

Konfigurasi izin

gid

Tidak

Menetapkan GID untuk semua file dan direktori di bawah titik mount.

GID pengguna yang melakukan mount sistem file

v2.0.1 dan seterusnya

uid

Tidak

Menetapkan UID untuk semua file dan direktori di bawah titik mount.

UID pengguna yang melakukan mount sistem file

v2.0.1 dan seterusnya

file_mode

Tidak

Menetapkan mode izin untuk semua file di bawah titik mount.

0777

v2.0.1 dan seterusnya

dir_mode

Tidak

Menetapkan mode izin untuk semua direktori di bawah titik mount.

0777

v2.0.1 dan seterusnya

allow_other

Tidak

Mengizinkan pengguna non-root mengakses file di bawah titik mount. Akses diverifikasi berdasarkan izin file.

true

v2.0.1 dan seterusnya

Kategori

Item konfigurasi

Wajib

Deskripsi

Nilai default

Versi yang didukung

Konfigurasi jaringan

bind_ips

Tidak

Daftar alamat IP sumber untuk akses OSS yang dipisahkan koma, seperti 192.168.0.1,192.168.0.2. Mengontrol NIC mana yang digunakan untuk meningkatkan throughput di lingkungan multi-NIC.

Kosong

v2.0.3 dan seterusnya

http_proxy

Tidak

Server proxy HTTP yang digunakan untuk meneruskan permintaan OSS.

Kosong

v2.0.8 dan seterusnya

Konfigurasi unggah

upload_buffer_size

Tidak

Ukuran buffer unggah multi-bagian (bagian) dalam byte. Ukuran file tertulis maksimum adalah upload_buffer_size × 10.000.

8388608

v2.0.0 dan seterusnya

upload_concurrency

Tidak

Konkurensi untuk unggah multi-bagian.

64

v2.0.0 dan seterusnya

sync_upload

Tidak

Menunggu unggahan selesai sebelum mengembalikan respons saat file ditutup.

true

v2.0.0 dan seterusnya

Konfigurasi unduh/Pra-ambil

prefetch_concurrency

Tidak

Konkurensi global untuk pra-ambil unduhan.

256

v2.0.0 dan seterusnya

prefetch_concurrency_per_file

Tidak

Konkurensi pra-ambil unduhan per handle file.

64

v2.0.0 dan seterusnya

prefetch_chunk_size

Tidak

Ukuran chunk pra-ambil, dalam byte.

8388608

v2.0.0 dan seterusnya

prefetch_chunks

Tidak

Jumlah chunk pra-ambil. Default-nya 3× prefetch_concurrency. Tetapkan ke -1 untuk memori pra-ambil tak terbatas per handle file.

0 (dikonfigurasi otomatis berdasarkan prefetch_concurrency)

v2.0.0 dan seterusnya

Konfigurasi manajemen memori

total_mem_limit

Tidak

Batas memori total dalam byte. Konkurensi unggah dan pra-ambil menyesuaikan otomatis terhadap batas ini.

Tanpa opsi ini, pra-ambil baca menggunakan buffer prefetch_chunk_size * prefetch_chunks dan penulisan menggunakan upload_buffer_size * upload_concurrency, mengalokasikan hingga ~8 GB total. Pastikan memori mencukupi untuk menghindari OOM.

Default-nya setengah dari memori sistem untuk sistem dengan memori ≤16 GB. Tidak ada batas untuk sistem dengan memori >16 GB.

0

v2.0.0 dan seterusnya

max_inode_cache_count

Tidak

Mengontrol jumlah entri metadata yang di-cache.

• 0 (default): Tidak ada kontrol aktif. OS secara otomatis menghapus metadata dari cache.

• Bilangan bulat positif: ossfs 2.0 menghapus entri berlebih saat jumlah cache melebihi nilai ini.

0

v2.0.4 dan seterusnya

Konfigurasi verifikasi file/Metadata

enable_crc64

Tidak

Mengaktifkan verifikasi CRC64 untuk penulisan file.

true

v2.0.0 dan seterusnya

close_to_open

Tidak

Mengaktifkan semantik close-to-open. Mengirim permintaan GetObjectMeta saat membuka file untuk memastikan metadata real-time.

Secara default dinonaktifkan, di mana pembukaan file memeriksa TTL cache metadata untuk menentukan apakah perlu mengkueri OSS. Jika diaktifkan, OSS selalu dikueri saat membuka file, yang secara signifikan meningkatkan latensi untuk banyak file kecil.

false

v2.0.0 dan seterusnya

Konfigurasi operasi file

rename_dir_limit

Tidak

Jumlah maksimum file dan direktori turunan dalam folder sumber untuk operasi rename. Melebihi batas ini menyebabkan rename gagal.

2000000

v2.0.0 dan seterusnya

enable_appendable_object

Tidak

Menggunakan operasi AppendObject untuk penulisan file, memungkinkan pembacaan dan penulisan konkuren pada file yang sama.

false

v2.0.0 dan seterusnya

appendable_object_autoswitch_threshold

Tidak

Saat enable_appendable_object diaktifkan, objek non-appendable dengan ukuran ≤ ambang batas ini (dalam byte) secara otomatis dikonversi menjadi objek appendable saat dilakukan append.

0

v2.0.5 dan seterusnya

Konfigurasi timeout permintaan

oss_request_timeout_ms

Tidak

Timeout untuk permintaan OSS, dalam milidetik.

60000

v2.0.0 dan seterusnya

Konfigurasi cache

oss_negative_cache_timeout

Tidak

TTL untuk item permintaan OSS 404 yang di-cache, dalam detik.

0

v2.0.2 dan seterusnya

oss_negative_cache_size

Tidak

Jumlah item permintaan OSS 404 yang di-cache.

10000

v2.0.2 dan seterusnya

memory_data_cache_size

Tidak

Mengalokasikan cache baca tetap di awal untuk mengurangi amplifikasi pra-ambil selama pembacaan konkuren. Meningkatkan performa untuk pemuatan model multi-GPU.

0

v2.0.5 dan seterusnya

kernel_readdir_cache_timeout

Tidak

TTL untuk cache direktori kernel, dalam detik. Memerlukan kernel Linux 4.20 atau lebih baru.

0

v2.0.7 dan seterusnya