Container Service for Kubernetes：Mount statically provisioned volumes with ossfs 1.0

Gunakan RRSA

Gunakan AccessKey

Metode RRSA

1. Buat file bernama pv-oss-rrsa.yaml.

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     # Nama PV
     name: pv-oss   
     # Label PV
     labels:    
       alicloud-pvname: pv-oss
   spec:
     capacity:
       # Tentukan kapasitas volume
       storage: 10Gi  
     # Mode akses
     accessModes:  
       - ReadOnlyMany
     persistentVolumeReclaimPolicy: Retain
     csi:
       driver: ossplugin.csi.alibabacloud.com
       # Harus sama dengan nama PV (metadata.name)
       volumeHandle: pv-oss  
       volumeAttributes:
         # Ganti dengan nama bucket aktual
         bucket: "your-bucket-name"  
         # Pasang direktori root atau subdirektori tertentu dari bucket
         path: /  
         # Titik akhir wilayah tempat bucket berada
         url: "http://oss-cn-hangzhou-internal.aliyuncs.com"  
         otherOpts: "-o umask=022 -o max_stat_cache_size=100000 -o allow_other"
         authType: "rrsa"
         # Peran RAM yang telah Anda buat atau modifikasi
         roleName: "demo-role-for-rrsa"
         # Versi signature permintaan OSS
         sigVersion: "v4"  

   Parameter	Deskripsi
   storage	Menentukan kapasitas volume OSS. Nilai ini hanya digunakan untuk mencocokkan PV dengan PVC.
   accessModes	Mengonfigurasi Mode Akses. Mendukung ReadOnlyMany dan ReadWriteMany. Jika Anda memilih ReadOnlyMany, ossfs memasang Bucket OSS dalam mode read-only.
   persistentVolumeReclaimPolicy	Kebijakan pengembalian PV. Volume OSS saat ini hanya mendukung Retain, artinya PV dan data di Bucket OSS tetap dipertahankan setelah PVC dihapus.
   driver	Menentukan jenis driver. Harus ossplugin.csi.alibabacloud.com saat menggunakan plug-in CSI OSS Alibaba Cloud.
   volumeHandle	Harus sama dengan nama PV (metadata.name).
   bucket	Bucket OSS yang akan dipasang.
   path	Membutuhkan versi komponen CSI v1.14.8.32-c77e277b-aliyun atau lebih baru. Menentukan jalur pemasangan relatif terhadap direktori root bucket. Default-nya adalah /, yang memasang seluruh bucket. Jika versi ossfs lebih awal dari 1.91, path yang ditentukan harus sudah ada di Bucket OSS. Untuk detailnya, lihat Fitur baru di ossfs 1.91 dan versi setelahnya.
   url	Titik akhir akses untuk bucket OSS. Gunakan titik akhir internal jika node kluster dan bucket berada di wilayah yang sama, atau jika koneksi Virtual Private Cloud (VPC) telah dibuat. Gunakan titik akhir publik jika node pemasangan dan bucket berada di wilayah berbeda. Berikut adalah format umum untuk berbagai titik akhir akses: Internal: http://oss-{{regionName}}-internal.aliyuncs.com atau https://oss-{{regionName}}-internal.aliyuncs.com. Format titik akhir akses internal vpc100-oss-{{regionName}}.aliyuncs.com sudah tidak digunakan lagi. Segera beralih ke format baru. Publik: http://oss-{{regionName}}.aliyuncs.com atau https://oss-{{regionName}}.aliyuncs.com.
   otherOpts	Masukkan parameter kustom untuk volume OSS dalam format -o *** -o ***, seperti -o umask=022 -o max_stat_cache_size=100000 -o allow_other. Lihat deskripsi umask: Mengubah izin baca untuk file ossfs. Misalnya, umask=022 mengubah izin file ossfs menjadi 755. Ini menyelesaikan masalah izin untuk file yang diunggah melalui metode lain, seperti SDK atau konsol OSS, yang memiliki izin default 640. Kami merekomendasikan mengonfigurasi parameter ini untuk pemisahan baca/tulis atau akses multi-pengguna. max_stat_cache_size: Menetapkan batas atas untuk entri cache metadata (misalnya, 100000). Ini menyimpan cache metadata objek di memori untuk meningkatkan kinerja operasi seperti ls dan stat. Namun, cache ini tidak dapat segera mendeteksi modifikasi file yang dilakukan melalui konsol OSS, SDK, atau ossutil. Hal ini dapat menyebabkan aplikasi membaca data yang tidak konsisten. Jika Anda memiliki persyaratan konsistensi data yang ketat, atur parameter ini ke 0 (untuk menonaktifkan cache) atau turunkan waktu kedaluwarsa cache dengan parameter stat_cache_expire. Hal ini akan mengurangi kinerja baca. allow_other: Mengizinkan pengguna selain pengguna yang memasang untuk mengakses file dan direktori di titik pemasangan. Ini cocok untuk lingkungan bersama multi-pengguna di mana pengguna non-pemasang juga perlu mengakses data. Untuk parameter opsional lainnya, lihat Opsi pemasangan dan Praktik terbaik konfigurasi ossfs 1.0.
   authType	Atur ke rrsa untuk menggunakan autentikasi RRSA.
   roleName	Atur ke peran RAM yang telah Anda buat atau modifikasi. Untuk mengonfigurasi izin berbeda untuk PV berbeda, buat peran RAM berbeda dan tentukan nilai roleName berbeda di PV tersebut.
   sigVersion	Versi signature untuk permintaan ke server OSS. "v1" (default): Menggunakan Signature Version 1 OSS. "v4" (direkomendasikan): Menggunakan Signature Version 4 OSS.

   Jika autentikasi RRSA default tidak memenuhi kebutuhan Anda (misalnya, jika Anda menggunakan ServiceAccount non-default atau OIDC pihak ketiga), Anda dapat memodifikasi konfigurasi PV untuk menentukan ARN atau ServiceAccount tertentu. Untuk informasi lebih lanjut, lihat Bagaimana cara menggunakan ARN atau ServiceAccount tertentu dengan autentikasi RRSA?.

2. Buat PV tersebut.

   kubectl create -f pv-oss-rrsa.yaml

Metode AccessKey

apiVersion: v1
kind: Secret
metadata:
  name: oss-secret
  # Harus sama dengan namespace tempat aplikasi berada
  namespace: default
stringData:
  # Ganti dengan ID AccessKey yang Anda peroleh
  akId: <your AccessKey ID>
  # Ganti dengan Rahasia AccessKey yang Anda peroleh
  akSecret: <your AccessKey Secret>

kubectl

1. Buat file bernama pvc-oss.yaml.

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     # Nama PVC
     name: pvc-oss
     namespace: default
   spec:
     # Konfigurasikan mode akses. ReadOnlyMany menunjukkan bahwa ossfs akan memasang Bucket OSS dalam mode read-only.
     accessModes:
       - ReadOnlyMany
     resources:
       requests:
         # Nyatakan kapasitas penyimpanan. Ini tidak boleh lebih besar dari total kapasitas volume.
         storage: 10Gi
     selector:
       matchLabels:
         # Cocokkan PV berdasarkan label-nya
         alicloud-pvname: pv-oss

2. Buat PVC tersebut.

   kubectl create -f pvc-oss.yaml

3. Periksa status PVC.

   kubectl get pvc pvc-oss

   Output menunjukkan bahwa PVC berada dalam status Bound ke PV.

   NAME      STATUS   VOLUME   CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGE
   pvc-oss   Bound    pv-oss   10Gi       ROX                           <unset>                 6s

Konsol

1. Pada halaman Clusters, temukan kluster yang diinginkan lalu klik namanya. Di panel kiri, pilih Volumes > Persistent Volume Claims.

2. Pada halaman PersistentVolumeClaims, klik Create. Pilih OSS sebagai PVC Type, lalu konfigurasikan parameter sesuai petunjuk.

   Tabel berikut mencantumkan parameter utama.

   Parameter	Deskripsi
   Provisioning Mode	Pilih Use Existing PersistentVolume. Jika Anda belum membuat PV, Anda dapat mengatur Provisioning Mode ke Create PersistentVolume dan mengonfigurasi parameter PV.
   Total Capacity	Kapasitas PVC, yang tidak boleh melebihi kapasitas PV.

kubectl

1. Buat file bernama oss-static.yaml.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: oss-static
     labels:
       app: nginx
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
           ports:
           - containerPort: 80
           volumeMounts:
             # Jalur pemasangan di dalam kontainer
             - name: pvc-oss
               mountPath: "/data"
           # Konfigurasikan pemeriksaan kesehatan
           livenessProbe:
             exec:
               command:
               - ls
               - /data
             initialDelaySeconds: 30
             periodSeconds: 30
         volumes:
           - name: pvc-oss
             persistentVolumeClaim:
               # Referensikan PVC yang telah Anda buat
               claimName: pvc-oss

2. Buat aplikasi tersebut.

   kubectl create -f oss-static.yaml

3. Verifikasi hasil pemasangan.

   • Pastikan Pod berada dalam status Running.

     kubectl get pod -l app=nginx

   • Masuk ke Pod dan periksa titik pemasangan.

     kubectl exec -it <pod-name> -- ls /data

     Output harus menampilkan data dari jalur pemasangan OSS.

Konsol