Saat membuat file konfigurasi ossfs 2.0, Anda dapat mengatur berbagai parameter untuk memenuhi kebutuhan pemasangan spesifik. File ini memungkinkan Anda memasang bucket OSS sebagai sistem file dengan cara yang berbeda sesuai berbagai kebutuhan bisnis.
Item konfigurasi dasar
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 lebih baru |
oss_bucket | Ya | Nama bucket. | Tidak ada | v2.0.0 dan lebih baru | |
Konfigurasi kredensial akses | oss_access_key_id | Bersyarat wajib | ID AccessKey. Parameter ini wajib untuk autentikasi AccessKey. | Tidak ada | v2.0.0 dan lebih baru |
oss_access_key_secret | Bersyarat wajib | Rahasia AccessKey. Parameter ini wajib untuk autentikasi AccessKey. | Tidak ada | v2.0.0 dan lebih baru | |
ram_role | Bersyarat wajib | Peran RAM ECS. Parameter ini diperlukan untuk otentikasi peran RAM ECS. | Tidak ada | v2.0.2 dan lebih baru | |
credential_process | Bersyarat wajib | Perintah untuk menjalankan proses eksternal guna mendapatkan kredensial akses. Parameter ini diperlukan untuk autentikasi proses eksternal. | Tidak ada | v2.0.5 dan yang lebih baru |
Item konfigurasi umum
Kategori | Item konfigurasi | Diperlukan | Deskripsi | Nilai default | Versi yang didukung |
Konfigurasi bucket | oss_bucket_prefix | Tidak | Memasang folder tertentu di dalam bucket. | Kosong | v2.0.0 dan lebih baru |
oss_region | Tidak | ID wilayah bucket. Digunakan untuk algoritma tanda tangan OSS V4. Jika Anda tidak menentukan parameter ini, algoritma tanda tangan OSS V1 digunakan. | Kosong | v2.0.0 dan lebih baru | |
Konfigurasi cache | attr_timeout | Tidak | Waktu hidup (TTL) untuk cache metadata file, dalam detik. | 60 | v2.0.0 dan lebih baru |
negative_timeout | Tidak | TTL untuk cache entri direktori yang tidak valid, dalam detik. | 0 | v2.0.0 dan lebih baru | |
readdirplus | Tidak | Mengaktifkan fitur readdirplus. Saat diaktifkan, cache metadata file dibangun secara sinkron selama operasi readdir. Ini mengonsumsi lebih banyak memori. | true | v2.0.0 dan lebih baru | |
Konfigurasi log | log_level | Tidak | Tingkat log. Nilai yang valid adalah info dan debug. | info | v2.0.0 dan lebih baru |
log_dir | Tidak | Folder tempat file log disimpan. | /tmp/ossfs2 | v2.0.0 dan lebih baru | |
log_file_max_size | Tidak | Ukuran maksimum file log tunggal, dalam byte. | 67108864 | v2.0.3 dan lebih baru | |
log_file_max_count | Tidak | Jumlah maksimum file log yang akan dipertahankan. | 8 | v2.0.3 dan lebih baru | |
Mode operasi | f | Tidak | Menentukan apakah akan dijalankan di foreground. | false | v2.0.0 dan lebih baru |
d | Tidak | Menentukan apakah akan dijalankan di foreground dan mengaktifkan log debug FUSE. | false | v2.0.0 dan lebih baru | |
Mode pemasangan | ro | Tidak | Memasang sistem file dalam mode read-only. | false | v2.0.0 dan lebih baru |
Konfigurasi izin | gid | Tidak | Jika dikonfigurasi, properti GID semua file dan folder di bawah titik pemasangan diatur ke nilai ini. | GID pengguna yang memasang sistem file | v2.0.1 dan lebih baru |
uid | Tidak | Jika dikonfigurasi, properti UID semua file dan folder di bawah titik pemasangan diatur ke nilai ini. | UID pengguna yang memasang sistem file | v2.0.1 dan lebih baru | |
file_mode | Tidak | Jika dikonfigurasi, properti izin semua file di bawah titik pemasangan diatur ke nilai ini. | 0777 | v2.0.1 dan lebih baru | |
dir_mode | Tidak | Jika dikonfigurasi, properti izin semua folder di bawah titik pemasangan diatur ke nilai ini. | 0777 | v2.0.1 dan lebih baru | |
allow_other | Tidak | Jika Anda mengatur `allow_other` ke `true`, pengguna non-root dapat mengakses file di bawah titik pemasangan. Akses diverifikasi berdasarkan izin file. | true | v2.0.1 dan lebih baru |
Konfigurasi lanjutan
Kategori | Item konfigurasi | Diperlukan | Deskripsi | Nilai default | Versi yang didukung |
Konfigurasi jaringan | bind_ips | Tidak | Mengikat daftar alamat IP tertentu sebagai IP sumber untuk mengakses OSS. Pisahkan alamat IP dengan koma. Contohnya, 192.168.0.1,192.168.0.2. Dengan menentukan daftar alamat IP, Anda dapat mengontrol network interface card (NIC) mana yang digunakan untuk mengakses OSS. Hal ini dapat meningkatkan total throughput di lingkungan multi-NIC. | Kosong | v2.0.3 dan lebih baru |
Konfigurasi unggah | upload_buffer_size | Tidak | Ukuran buffer unggah multi-bagian, dalam byte. Ini juga merupakan ukuran bagian. Parameter ini menentukan ukuran maksimum file yang dapat ditulis. Ukuran file maksimum dihitung sebagai `upload_buffer_size` × 10.000. | 8388608 | v2.0.0 dan lebih baru |
upload_concurrency | Tidak | Konkurensi untuk unggah multi-bagian. | 64 | v2.0.0 dan lebih baru | |
sync_upload | Tidak | Jika diaktifkan, sistem menunggu hingga file benar-benar selesai diunggah sebelum mengembalikan respons saat file ditutup. | true | v2.0.0 dan lebih baru | |
Konfigurasi Unduh/Pra-ambil | prefetch_concurrency | Tidak | Konkurensi global untuk pra-ambil unduhan. | 256 | v2.0.0 dan lebih baru |
prefetch_concurrency_per_file | Tidak | Konkurensi pra-ambil unduhan per handle file. | 64 | v2.0.0 dan lebih baru | |
prefetch_chunk_size | Tidak | Ukuran chunk pra-ambil, dalam byte. | 8388608 | v2.0.0 dan lebih baru | |
prefetch_chunks | Tidak | Jumlah chunk pra-ambil. Jika tidak diatur, nilai default adalah tiga kali nilai `prefetch_concurrency`. Jika diatur ke -1, memori pra-ambil tidak dibatasi. Setiap handle file dapat mengalokasikan memori yang cukup untuk pra-ambil. | 0 (dikonfigurasi otomatis berdasarkan prefetch_concurrency) | v2.0.0 dan lebih baru | |
Konfigurasi manajemen memori | total_mem_limit | Tidak | Batas memori total, dalam byte. Jika diatur, konkurensi untuk unggah dan pra-ambil secara otomatis disesuaikan berdasarkan batas ini. Jika Anda tidak mengonfigurasi opsi ini, buffer Untuk lingkungan dengan memori 16 GB atau kurang, nilai default `total_mem_limit` adalah setengah dari memori sistem. Untuk lingkungan dengan memori lebih dari 16 GB, tidak ada batasan. | 0 | v2.0.0 dan lebih baru |
max_inode_cache_count | Tidak | Mengaktifkan kontrol aktif terhadap jumlah entri metadata yang di-cache.
| 0 | v2.0.4 dan yang lebih baru | |
Konfigurasi verifikasi file/Konfigurasi metadata | enable_crc64 | Tidak | Menentukan apakah akan mengaktifkan pemeriksaan redundansi siklik (CRC) untuk penulisan file. | true | v2.0.0 dan lebih baru |
close_to_open | Tidak | Mendukung semantik close-to-open. Jika Anda mengaktifkan opsi ini, permintaan GetObjectMeta dikirim untuk mendapatkan informasi file dari OSS saat file dibuka. Hal ini memastikan metadata real-time. Secara default, opsi ini dinonaktifkan. Saat file dibuka, sistem menentukan apakah akan mengirim permintaan ke OSS untuk properti file terbaru berdasarkan TTL cache metadata. Jika Anda mengaktifkan opsi ini, permintaan selalu dikirim ke OSS saat file dibuka. Hal ini secara signifikan meningkatkan latensi akses saat membaca banyak file kecil. | false | v2.0.0 dan lebih baru | |
Konfigurasi operasi file | rename_dir_limit | Tidak | Jumlah total maksimum file dan folder turunan dalam folder sumber untuk satu operasi rename. Jika jumlah aktual melebihi batas ini, operasi rename gagal. | 2000000 | v2.0.0 dan lebih baru |
enable_appendable_object | Tidak | Jika diaktifkan, operasi AppendObject digunakan untuk penulisan file. Mode ini mendukung pembacaan file saat sedang ditulis. | false | v2.0.0 dan lebih baru | |
appendable_object_autoswitch_threshold | Tidak | Saat `enable_appendable_object` diaktifkan, objek non-appendable di OSS yang ukurannya lebih kecil dari atau sama dengan ambang batas ini (dalam byte) secara otomatis dikonversi menjadi objek appendable saat data ditambahkan. | 0 | v2.0.5 dan yang lebih baru | |
Konfigurasi timeout permintaan | oss_request_timeout_ms | Tidak | Periode timeout untuk permintaan yang dikirim ke OSS, dalam milidetik. | 60000 | v2.0.0 dan 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 lebih baru |
oss_negative_cache_size | Tidak | Jumlah item permintaan OSS 404 yang di-cache. | 10000 | v2.0.2 dan lebih baru | |
memory_data_cache_size | Tidak | Dalam mode ini, jumlah tetap memori dialokasikan sebelumnya untuk cache baca. Ini terutama digunakan untuk mengatasi masalah amplifikasi pra-ambil saat membaca file secara konkuren. Hal ini secara efektif dapat meningkatkan performa saat memuat model besar pada beberapa GPU. | 0 | v2.0.5 dan yang lebih baru |
Referensi
Untuk contoh file konfigurasi dalam skenario umum ossfs 2.0, lihat Konfigurasikan ossfs 2.0.
Untuk informasi lebih lanjut, lihat Pasang bucket ke sistem file lokal menggunakan ossfs 2.0.