Konfigurasi ossfs lanjutan - Object Storage Service - Alibaba Cloud Documentation Center

Topik ini menjelaskan cara menggunakan ossfs 1.0 untuk memasang bucket OSS ke sistem file lokal di Linux.

Prasyarat

Anda telah menginstal ossfs 1.0 dan mengonfigurasi ossfs 1.0.

Format perintah pasang

Format perintah: ossfs bucket_name /tmp/ossfs -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou
Deskripsi parameter
- ossfs: Perintah ossfs.
- bucket_name: Nama bucket yang akan dipasang.
- /tmp/ossfs: Direktori lokal tempat bucket dipasang, juga dikenal sebagai titik pemasangan (mount point).
- -o: Awalan wajib untuk opsi pemasangan.
- url=http://oss-cn-hangzhou.aliyuncs.com: Opsi pemasangan url menentukan titik akhir bucket target. Format nilainya adalah http://endpoint.
  
  Untuk menemukan titik akhir bucket Anda, buka halaman Bucket List, pilih bucket Anda, lalu klik Overview di panel navigasi kiri. Bagian Port menampilkan titik akhir tersebut. Contoh ini menggunakan bucket di wilayah China (Hangzhou).
  
  Terdapat titik akhir lain untuk lingkungan jaringan tertentu: oss-cn-hangzhou-internal.aliyuncs.com untuk akses dari instance ECS melalui jaringan klasik atau jaringan VPC (internal), oss-accelerate.aliyuncs.com untuk domain Transfer Acceleration global, dan cn-hangzhou-internal.oss-data-acc.aliyuncs.com untuk OSS Accelerator. Pilih titik akhir sesuai dengan lingkungan jaringan Anda.
- sigv4: Mengaktifkan signature V4. Tambahkan -osigv4 ke perintah pemasangan Anda. Secara default, ossfs menggunakan signature V1. Jika Anda menambahkan opsi pemasangan ini, ossfs mengirim permintaan ke OSS menggunakan proses signature V4.
- region=cn-hangzhou: ID wilayah untuk permintaan bucket OSS. Tambahkan -oregion=<region_id> saat memasang bucket. Nilai default-nya kosong. Opsi ini wajib digunakan saat menggunakan signature V4 untuk menentukan wilayah permintaan.

Pemasangan dasar

Pemasangan menggunakan file konfigurasi

Buat direktori pemasangan.

Jalankan perintah berikut untuk membuat direktori kosong /tmp/ossfs-1 dan /tmp/ossfs-2 sebagai titik pemasangan untuk bucket Anda.
```
mkdir /tmp/ossfs-1 /tmp/ossfs-2
```

Contoh mount.

Jalankan perintah berikut untuk memasang bucket-test-1 dan bucket-test-2, yang dikonfigurasi dalam file konfigurasi default, masing-masing ke direktori /tmp/ossfs-1 dan /tmp/ossfs-2.

ossfs bucket-test-1 /tmp/ossfs-1/ -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou
ossfs bucket-test-2 /tmp/ossfs-2/ -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou

Output-nya sebagai berikut.

root@i-xxx:~# ossfs xxx /tmp/ossfs-1 -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou
[NOTICE] OSS signature V1 service will not be available for new uids since March 1st, 2025. It is recommended to mount with OSS signature V4:
    ossfs [oss-bucket] [mount-path] [options] -osigv4 -oregion=[your-region-id]
root@i-xxx:~#
root@i-xxx                :~# df -h /tmp/ossfs-1
Filesystem      Size  Used Avail Use% Mounted on
ossfs            16E     0   16E   0% /tmp/ossfs-1

Pemasangan menggunakan peran RAM ECS

Buat direktori pemasangan.

Jalankan perintah berikut untuk membuat direktori kosong /tmp/ossfs sebagai titik pemasangan untuk bucket Anda.
```
mkdir /tmp/ossfs
```
Contoh pemasangan.

Catatan
Saat memasang ossfs menggunakan URL metadata instans, hanya mode akses normal yang didukung. Untuk informasi selengkapnya tentang mode akses metadata, lihat instance metadata.

Jalankan perintah berikut untuk memasang bucket bernama bucket1 ke direktori lokal /tmp/ossfs.

Catatan: Saat memasang bucket menggunakan peran RAM ECS, Anda harus menentukan URL metadata instans dengan parameter ram_role. Alamat IP 100.100.100.200 adalah alamat default untuk layanan instance metadata Alibaba Cloud ECS dan tidak boleh diubah. Ganti EcsRamRoleOssTest dengan nama peran yang disambungkan ke instance ECS Anda. Jangan ubah informasi lainnya.
```
ossfs bucket1 /tmp/ossfs -o url=http://oss-cn-hangzhou.aliyuncs.com -o ram_role=http://100.100.100.200/latest/meta-data/ram/security-credentials/EcsRamRoleOssTest -o sigv4 -o region=cn-hangzhou
```

Output-nya sebagai berikut.

root@xxx         xxx:~# ossfs  xxx  /tmp/ossfs -o url=http://oss-cn-hangzhou.aliyuncs.com -o ram role=http://100.100.100.200/latest/meta-data/ram/security-credentials/xxx  -o sigv4 -o region=cn-hangzhou
[NOTICE] OSS signature V1 service will not be available for new uids since March 1st, 2025. It is recommended to mount with OSS signature V4:
        ossfs [oss-bucket] [mount-path] [options] -osigv4 -oregion=[your-region-id]
root@xxx         xxx:~#
root@xxx         xxx:~# df -h /tmp/ossfs
Filesystem  Size  Used  Avail Use% Mounted on
ossfs       16E   0     16E   0%   /tmp/ossfs

Pemasangan dalam skenario tertentu

Anda dapat memasang direktori tertentu atau menambahkan opsi pemasangan. Untuk daftar opsi lengkap, lihat mount options. Catatan: Sebelum menjalankan perintah pasang, pastikan direktori pemasangan lokal kosong.

Pemasangan direktori tertentu

Jalankan perintah berikut untuk memasang direktori folder dalam bucket bucket-ossfs-test ke direktori lokal /tmp/ossfs-folder.

ossfs bucket-ossfs-test:/folder /tmp/ossfs-folder -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou

Pemasangan menggunakan file konfigurasi tertentu

Opsi pemasangan: Gunakan opsi pemasangan passwd_file untuk menentukan path ke file konfigurasi ossfs 1.0 non-default. Atur izin file tersebut menjadi 600.
Contoh pemasangan

Jalankan perintah berikut untuk memasang bucket-test-3, yang dikonfigurasi dalam file konfigurasi tertentu, ke direktori lokal /tmp/ossfs-3.
```
ossfs bucket-test-3 /tmp/ossfs-3 -o url=http://oss-cn-hangzhou.aliyuncs.com -o passwd_file=/etc/passwd-ossfs-3 -o sigv4 -o region=cn-hangzhou
```

Mengaktifkan log debug saat pemasangan

Opsi pemasangan: Opsi pemasangan dbglevel mengatur tingkat log. Tingkat log berikut didukung: critical, error, warn, info, dan debug. Nilai default-nya adalah critical. Secara default, log disimpan ke /var/log/messages pada sistem CentOS dan ke /var/log/syslog pada sistem Ubuntu. Anda juga dapat menggunakan opsi pemasangan logfile untuk menentukan path kustom untuk file log.
Contoh pemasangan 1

Jalankan perintah berikut untuk memasang bucket-ossfs-test-1 ke direktori lokal /tmp/ossfs-1. Dalam perintah ini, opsi -d ditambahkan untuk mengaktifkan log debug libfuse, dan opsi pemasangan dbglevel digunakan untuk mengatur tingkat log menjadi debug.
```
ossfs bucket-ossfs-test-1 /tmp/ossfs-1 -d -o dbglevel=debug -o sigv4 -o region=cn-hangzhou
```
Contoh pemasangan 2

Jalankan perintah berikut untuk memasang bucket-ossfs-test-2 ke direktori lokal /tmp/ossfs-2. Tingkat log diatur ke debug dan log debug libfuse diaktifkan. Pesan log dicetak ke terminal foreground menggunakan opsi -f.
```
ossfs bucket-ossfs-test-2 /tmp/ossfs-2 -d -o dbglevel=debug -f -o sigv4 -o region=cn-hangzhou
```

Mengonfigurasi izin akses saat pemasangan

Secara default, hanya pengguna yang menjalankan perintah pasang (pemilik) yang dapat mengakses direktori yang dipasang. Untuk mengizinkan pengguna lain mengakses titik pemasangan, konfigurasikan parameter berikut saat memasang bucket.

Parameter	Deskripsi
allow_other	Mengizinkan semua pengguna mengakses direktori titik pemasangan itu sendiri, tetapi tidak termasuk file di dalamnya. Anda harus mengatur izin file secara terpisah. Gunakan perintah `chmod` untuk mengubah izin file individual. Untuk menerapkan izin seragam ke semua file, konfigurasikan opsi `umask`.
uid	UID pengguna yang memiliki direktori tersebut.
gid	GID kelompok yang memiliki direktori tersebut.
umask	Mengatur mask izin untuk file dan direktori di titik pemasangan. Misalnya, untuk mengatur izin di titik pemasangan menjadi 770, tambahkan -o umask=007. Untuk mengatur izin menjadi 700, tambahkan -o umask=077.

Contoh pemasangan 1

Jalankan perintah berikut untuk memasang bucket_name ke direktori lokal mount_point dan gunakan opsi pemasangan allow_other untuk memberikan akses kepada semua pengguna. Ini mengatur izin direktori pemasangan menjadi 777.
```
ossfs bucket_name mount_point -o url=endpoint -o allow_other -o sigv4 -o region=cn-hangzhou
```
Contoh pemasangan 2

Jalankan perintah berikut untuk memasang bucket_name ke direktori lokal mount_point dan gunakan opsi pemasangan umask untuk mengatur izin direktori pemasangan dan file di dalamnya menjadi 770. Ini hanya mengizinkan akses bagi pengguna dalam kelompok yang sama.
```
ossfs bucket_name mount_point -o url=endpoint -o umask=007 -o sigv4 -o region=cn-hangzhou
```
Contoh pemasangan 3
1. Jalankan perintah berikut untuk mendapatkan UID, GID, dan kelompok pengguna tertentu. Pengguna www digunakan dalam contoh ini.
```
id www
```
  Output perintah sebagai berikut.
```
root@iZbp1325rf1sja6ye4kbm2Z:~# id www
uid=xxx(www) gid=xxx(www) groups=xxx(www)
```
2. Jalankan perintah berikut untuk memasang bucket_name ke direktori lokal mount_point dan gunakan opsi pemasangan uid dan gid untuk menentukan pengguna dan kelompok. Konfigurasi ini memberikan akses hanya kepada pengguna dalam kelompok yang sama dan mengatur izin menjadi 770. Nilai uid dan gid dalam contoh ini adalah 1000. Sebelum menjalankan perintah pasang, ganti nilai-nilai ini dengan uid dan gid pengguna target Anda.
```
ossfs bucket_name mount_point -o url=endpoint -o allow_other -o uid=1000 -o gid=1000 -o umask=007 -o sigv4 -o region=cn-hangzhou
```

Tips berguna

Pemasangan otomatis saat startup

Bucket yang dipasang secara manual tidak akan dipasang ulang secara otomatis setelah sistem restart. Untuk mengaktifkan pemasangan otomatis saat startup, ikuti langkah-langkah berikut. Sebelum mengaktifkan pemasangan otomatis, pastikan pemasangan manual berhasil. Hal ini mencegah kegagalan startup ECS. Metode berikut mengaktifkan pemasangan otomatis setelah Anda mengonfigurasi ossfs dengan Pasangan Kunci Akses (AccessKey pair).

Tulis nama bucket, ID AccessKey, Rahasia AccessKey, dan informasi lainnya ke file /etc/passwd-ossfs, lalu atur izin file tersebut menjadi 640.

Untuk informasi lebih lanjut tentang langkah konfigurasi, lihat Configure ossfs 1.0.

Atur pemasangan otomatis saat startup.

Catatan

Contoh berikut menunjukkan cara mengaktifkan pemasangan otomatis saat startup untuk distribusi dan versi umum. Untuk distribusi dan versi lainnya, rujuk dokumentasi distribusi Anda.

Pasang dengan fstab

Tambahkan baris berikut ke file /etc/fstab:

ossfs#bucket_name mount_point fuse _netdev,url=url,allow_other 0 0

Tabel berikut menjelaskan parameter-parameter tersebut.

Parameter	Deskripsi
bucket_name	Nama bucket yang akan dipasang. Ganti `bucket_name` dengan nama bucket Anda.
mount_point	Direktori pemasangan lokal. Ganti `mount_point` dengan path direktori pemasangan lokal Anda.
url=url	Titik akhir bucket target.
0 0	Opsi sistem file.

Simpan file /etc/fstab. Jalankan perintah mount -a -t fuse. Jika tidak ada error yang dilaporkan, konfigurasi sudah benar.
Setelah langkah sebelumnya selesai, pemasangan otomatis diaktifkan pada Ubuntu 14.04. Untuk CentOS 6.5, Anda juga harus menjalankan perintah berikut:
```
chkconfig netfs on
```

Pasang dengan skrip startup

Buat file bernama ossfs di direktori /etc/init.d/, lalu salin konten berikut ke file tersebut. Ganti nilai dalam perintah pasang dengan informasi bucket target Anda.

#! /bin/bash
#
# ossfs      Automount Aliyun OSS Bucket in the specified direcotry.
#
# chkconfig: 2345 90 10
# description: Activates/Deactivates ossfs configured to start at boot time.
ossfs your_bucket your_mountpoint -ourl=your_url -oallow_other

Berikan izin eksekusi ke skrip ossfs yang baru:
```
chmod a+x /etc/init.d/ossfs
```
Setelah perintah dijalankan, Anda dapat mencoba menjalankan skrip tersebut. Jika isi skrip benar, bucket OSS akan dipasang ke direktori yang ditentukan.
Konfigurasikan skrip ossfs agar berjalan saat boot sebagai layanan:
```
chkconfig ossfs on
```
Setelah menyelesaikan langkah-langkah di atas, ossfs akan dipasang secara otomatis saat startup.

Penting

chkconfig tidak secara otomatis menjalankan ulang ossfs jika proses tersebut berhenti secara tak terduga. Perintah ini hanya memastikan bahwa ossfs berjalan otomatis saat boot.

Lepas pemasangan bucket

Untuk melepas pemasangan bucket, jalankan perintah berikut. Misalnya, untuk melepas sistem file yang dipasang di /tmp/ossfs:

umount /tmp/ossfs

FAQ

Untuk memasang bucket OSS pada sistem Windows, gunakan Cloud Storage Gateway (CSG). Untuk informasi selengkapnya, lihat Use a file gateway in the Alibaba Cloud console dan Access an SMB shared directory.
Memasang bucket OSS dari instance ECS melalui titik akhir internal tidak dikenai biaya trafik. Untuk informasi selengkapnya tentang biaya trafik, lihat Traffic fees.
Jika instance ECS dan bucket OSS Anda berada di wilayah berbeda dan Anda perlu memasang bucket lintas wilayah, pastikan konektivitas jaringan tersedia. Anda dapat langsung menggunakan titik akhir publik untuk memasang bucket. Anda juga dapat mengaktifkan instance ECS untuk mengakses layanan OSS di wilayah lain melalui jaringan pribadi.
Jika Anda perlu membangun website IIS menggunakan Cloud Storage Gateway dan menggunakan OSS untuk penyimpanan data, lihat Build an IIS website by using Alibaba Cloud Storage Gateway.
Jika Anda perlu memasang bucket OSS pada sistem operasi Windows, lihat Rclone.
Untuk informasi selengkapnya tentang masalah terkait pemasangan dan izin, lihat FAQ.