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 yang lebih baru

oss_bucket

Ya

Nama bucket.

Tidak ada

v2.0.0 dan yang lebih baru

Konfigurasi kredensial akses

oss_access_key_id

Bersyarat wajib

ID AccessKey. Diperlukan untuk autentikasi AccessKey.

Tidak ada

v2.0.0 dan yang lebih baru

oss_access_key_secret

Bersyarat wajib

Rahasia AccessKey. Diperlukan untuk autentikasi AccessKey.

Tidak ada

v2.0.0 dan yang lebih baru

ram_role

Bersyarat wajib

Peran RAM ECS. Diperlukan untuk autentikasi peran RAM ECS.

Tidak ada

v2.0.2 dan yang lebih baru

credential_process

Bersyarat wajib

Perintah untuk menjalankan proses eksternal guna memperoleh kredensial akses.

Diperlukan untuk autentikasi proses eksternal.

Tidak ada

v2.0.5 dan yang lebih baru

Kategori

Item konfigurasi

Wajib

Deskripsi

Nilai default

Versi yang didukung

Konfigurasi bucket

oss_bucket_prefix

Tidak

Memasang folder tertentu di dalam bucket.

Kosong

v2.0.0 dan yang lebih baru

oss_region

Tidak

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

Kosong

v2.0.0 dan yang lebih baru

Konfigurasi cache

attr_timeout

Tidak

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

60

v2.0.0 dan yang lebih baru

negative_timeout

Tidak

TTL cache entri direktori yang tidak valid, dalam detik.

0

v2.0.0 dan yang lebih baru

readdirplus

Tidak

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

true

v2.0.0 dan yang lebih baru

disk_data_cache_dir

Tidak

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

Kosong

v2.0.8 dan yang lebih baru

disk_data_cache_size

Bersyarat wajib

Kapasitas cache maksimum, diselaraskan ke satuan GiB. Nilai ini tidak boleh melebihi ruang disk atau partisi yang tersedia tempat direktori cache berada. disk_data_cache_dir dapat dibiarkan kosong. Jika disk_data_cache_dir ditentukan, parameter ini harus diatur ke nilai yang valid.

Kosong

v2.0.8 dan yang lebih baru

disk_data_cache_io_engine

Tidak

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

psync

v2.0.8 dan yang lebih baru

Konfigurasi mode tulis

temp_dir

Tidak

Jalur direktori sementara lokal. Harus berupa jalur mutlak. Menetapkan nilai non-kosong akan mengaktifkan mode tulis acak berbasis direktori sementara lokal, yang mendukung semantik tulis POSIX penuh seperti penulisan pada offset arbitrer dan pemotongan ke ukuran apa pun. Biarkan kosong untuk menonaktifkan fitur ini. Untuk informasi selengkapnya, lihat Configure a local temporary directory to support random writes.

Kosong

v2.0.9 dan yang lebih baru

temp_dir_free_bytes

Tidak

Ruang disk bebas minimum yang dicadangkan pada disk tempat direktori sementara berada, dalam byte (mendukung satuan seperti K, M, dan G). Ketika ruang disk bebas turun di bawah ambang batas ini, operasi tulis baru akan mengembalikan ENOSPC. Jika ruang disk bebas sudah berada di bawah nilai ini saat pemasangan, proses mount akan gagal. Nilai minimum: 64 MiB.

1 GiB

v2.0.9 dan yang lebih baru

random_write_max_file_size

Tidak

Ukuran logis maksimum objek tunggal dalam mode tulis acak, dalam byte (mendukung satuan seperti K, M, dan G). Operasi tulis atau pemotongan yang melebihi batas ini akan mengembalikan EFBIG. Batas fisik atas adalah kapasitas unggah multi-bagian OSS (10.000 bagian × 5 GiB, sekitar 48,8 TiB).

100 GiB

v2.0.9 dan yang lebih baru

Konfigurasi log

log_level

Tidak

Tingkat log. Nilai yang valid adalah info dan debug.

info

v2.0.0 dan yang lebih baru

log_dir

Tidak

Folder tempat file log disimpan.

/tmp/ossfs2

v2.0.0 dan yang lebih baru

log_file_max_size

Tidak

Ukuran maksimum file log tunggal, dalam byte.

67108864

v2.0.3 dan yang lebih baru

log_file_max_count

Tidak

Jumlah maksimum file log yang disimpan.

8

v2.0.3 dan yang lebih baru

Mode berjalan

f

Tidak

Menjalankan ossfs di latar depan.

false

v2.0.0 dan yang lebih baru

d

Tidak

Menjalankan ossfs di latar depan dengan log debug FUSE diaktifkan.

false

v2.0.0 dan yang lebih baru

Mode mount

ro

Tidak

Memasang sistem file dalam mode read-only.

false

v2.0.0 dan yang lebih baru

Konfigurasi izin

gid

Tidak

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

GID pengguna yang memasang sistem file

v2.0.1 dan yang lebih baru

uid

Tidak

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

UID pengguna yang memasang sistem file

v2.0.1 dan yang lebih baru

file_mode

Tidak

Menetapkan mode izin untuk semua file di bawah titik mount.

0777

v2.0.1 dan yang lebih baru

dir_mode

Tidak

Menetapkan mode izin untuk semua direktori di bawah titik mount.

0777

v2.0.1 dan yang lebih baru

allow_other

Tidak

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

true

v2.0.1 dan yang lebih baru

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 yang lebih baru

http_proxy

Tidak

Server proxy HTTP yang digunakan untuk meneruskan permintaan OSS.

Kosong

v2.0.8 dan yang lebih baru

path_style

Tidak

Setelah opsi ini diaktifkan, Anda dapat memasang bucket menggunakan domain PrivateLink.

false

v2.0.10 dan yang lebih baru

enable_ipv6

Tidak

Menentukan apakah akan mengakses OSS menggunakan alamat IPv6.

true

v2.0.10 dan yang lebih baru

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 yang lebih baru

upload_concurrency

Tidak

Konkurensi untuk unggah multi-bagian.

64

v2.0.0 dan yang lebih baru

sync_upload

Tidak

Menunggu unggahan selesai sebelum mengembalikan respons saat file ditutup.

true

v2.0.0 dan yang lebih baru

Konfigurasi unduh/Pra-ambil

prefetch_concurrency

Tidak

Konkurensi global untuk pra-ambil unduhan.

256

v2.0.0 dan yang lebih baru

prefetch_concurrency_per_file

Tidak

Konkurensi pra-ambil unduhan per handle file.

64

v2.0.0 dan yang lebih baru

prefetch_chunk_size

Tidak

Ukuran chunk pra-ambil, dalam byte.

8388608

v2.0.0 dan yang lebih baru

prefetch_chunks

Tidak

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

0 (dikonfigurasi otomatis berdasarkan prefetch_concurrency)

v2.0.0 dan yang lebih baru

Konfigurasi manajemen memori

total_mem_limit

Tidak

Batas memori total dalam byte. Konkurensi unggah dan pra-ambil menyesuaikan otomatis sesuai 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 yang lebih baru

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 ketika jumlah cache melebihi nilai ini.

0

v2.0.4 dan yang lebih baru

Konfigurasi verifikasi file/Metadata

enable_crc64

Tidak

Mengaktifkan verifikasi CRC64 untuk penulisan file.

true

v2.0.0 dan yang lebih baru

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 melakukan kueri ke OSS. Mengaktifkan opsi ini selalu melakukan kueri ke OSS saat membuka file, yang secara signifikan meningkatkan latensi untuk banyak file kecil.

false

v2.0.0 dan yang lebih baru

Konfigurasi operasi file

rename_dir_limit

Tidak

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

2000000

v2.0.0 dan yang lebih baru

enable_appendable_object

Tidak

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

false

v2.0.0 dan yang lebih baru

appendable_object_autoswitch_threshold

Tidak

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

0

v2.0.5 dan yang lebih baru

enable_symlink

Tidak

Mengaktifkan fitur symlink. Symlink hanya dapat dibuat di dalam titik mount menggunakan jalur relatif.

false

v2.0.6 dan yang lebih baru

Konfigurasi timeout permintaan

oss_request_timeout_ms

Tidak

Timeout untuk permintaan OSS, dalam milidetik.

60000

v2.0.0 dan yang lebih baru

Konfigurasi cache

oss_negative_cache_timeout

Tidak

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

0

v2.0.2 dan yang lebih baru

oss_negative_cache_size

Tidak

Jumlah item permintaan OSS 404 yang di-cache.

10000

v2.0.2 dan yang lebih baru

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 yang lebih baru

kernel_readdir_cache_timeout

Tidak

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

0

v2.0.7 dan yang lebih baru