Container Service for Kubernetes:Mount a static OSS volume using ossfs 1.0

RRSA

AccessKey

Gunakan 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:
       # Kapasitas volume persisten.
       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 Anda.
         bucket: "your-bucket-name"  
         # Direktori root atau subdirektori bucket yang akan dipasang.
         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 sebelumnya Anda buat atau modifikasi.
         roleName: "demo-role-for-rrsa"
         # Versi signature untuk permintaan OSS.
         sigVersion: "v4"  

   Parameter	Deskripsi
   storage	Kapasitas volume persisten OSS. Nilai ini hanya digunakan untuk mencocokkan PV dengan PVC.
   accessModes	Menentukan mode akses. Nilai yang valid meliputi ReadOnlyMany dan ReadWriteMany. Jika Anda mengatur parameter ini ke ReadOnlyMany, ossfs memasang bucket OSS dalam mode read-only.
   persistentVolumeReclaimPolicy	Kebijakan pemulihan PV. Volume persisten OSS hanya mendukung Retain. Artinya, ketika PVC dihapus, PV dan data di bucket OSS tetap dipertahankan.
   driver	Jenis driver. Saat menggunakan plugin CSI OSS Alibaba Cloud, atur bidang ini ke ossplugin.csi.alibabacloud.com.
   volumeHandle	Harus sama dengan nama PV yang ditentukan di metadata.name.
   bucket	Bucket OSS yang akan dipasang.
   path	Versi komponen CSI harus v1.14.8.32-c77e277b-aliyun atau lebih baru. Jalur pemasangan relatif terhadap direktori root bucket. Nilai default adalah /, yang memasang seluruh bucket. Jika versi ossfs lebih awal dari 1.91, path yang ditentukan harus ada di bucket OSS. Untuk informasi lebih lanjut, lihat Fitur baru di ossfs 1.91 dan versi selanjutnya.
   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 titik akhir akses berbeda: Internal: http://oss-{{regionName}}-internal.aliyuncs.com atau https://oss-{{regionName}}-internal.aliyuncs.com. Catatan 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	Parameter kustom untuk volume persisten OSS, dalam format -o *** -o ***. Contoh: -o umask=022 -o max_stat_cache_size=100000 -o allow_other. Perluas untuk detail umask: Mengatur mask izin untuk file dan direktori. Misalnya, umask=022 mengubah izin file menjadi 755. Ini menyelesaikan masalah izin untuk file yang diunggah menggunakan 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: Mengatur batas atas entri cache metadata, misalnya 100000. Metadata di-cache di memori untuk meningkatkan kinerja operasi seperti ls dan stat. Namun, cache ini tidak dapat langsung 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 kurangi waktu kedaluwarsa cache dengan menggunakan parameter stat_cache_expire. Namun, hal ini dapat mengurangi kinerja baca. allow_other: Mengizinkan pengguna selain pengguna yang memasang volume untuk mengakses file dan direktori di jalur pemasangan. Ini cocok untuk lingkungan bersama multi-pengguna di mana pengguna non-pemasang juga perlu mengakses data. Untuk informasi lebih lanjut tentang parameter opsional, lihat Opsi pemasangan dan Praktik terbaik untuk mengonfigurasi ossfs 1.0.
   authType	Atur parameter ini ke rrsa untuk menggunakan RRSA sebagai autentikasi.
   roleName	Peran RAM yang sebelumnya Anda buat atau modifikasi. Untuk mengonfigurasi izin berbeda untuk PV berbeda, Anda dapat membuat peran RAM berbeda dan menentukan nilai roleName berbeda di PV.
   sigVersion	Versi signature untuk permintaan yang dikirim 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.

   kubectl create -f pv-oss-rrsa.yaml

Gunakan AccessKey

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 memasang bucket OSS dalam mode read-only.
     accessModes:
       - ReadOnlyMany
     resources:
       requests:
         # Kapasitas penyimpanan yang diminta. Nilai ini tidak boleh melebihi kapasitas PersistentVolume.
         storage: 10Gi
     # Tambahkan baris ini untuk secara eksplisit menentukan bahwa tidak ada StorageClass yang digunakan.
     storageClassName: ""   
     selector:
       matchLabels:
         # Cocokkan PV berdasarkan label-nya.
         alicloud-pvname: pv-oss

2. Buat PVC.

   kubectl create -f pvc-oss.yaml

3. Periksa status PVC.

   kubectl get pvc pvc-oss

   Output mengonfirmasi bahwa PVC terikat ke PV.

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

Konsol

1. Pada halaman ACK Clusters, klik nama kluster Anda. Di panel navigasi kiri, klik Volumes > Persistent Volume Claims.

2. Pada halaman Persistent Volume Claims, klik Create, pilih OSS sebagai PVC Type, dan ikuti petunjuk di layar untuk mengonfigurasi parameter serta mengirimkan permintaan.

   Tabel berikut menjelaskan parameter utama.

   Parameter	Deskripsi
   Allocation Mode	Pilih Use Existing PersistentVolume. Jika Anda belum membuat volume persisten, Anda dapat mengatur Allocation Mode ke Create PV dan mengonfigurasi parameter untuk volume baru.
   Total capacity	Kapasitas penyimpanan PVC, yang tidak boleh melebihi kapasitas PersistentVolume.

kubectl

1. Buat file oss-workload.yaml.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: oss-workload
     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 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 Anda buat.
               claimName: pvc-oss

2. Buat aplikasi.

   kubectl create -f oss-workload.yaml

3. Verifikasi pemasangan.

   • Konfirmasi bahwa Pod sedang Berjalan.

     kubectl get pod -l app=nginx

   • Akses Pod dan periksa titik pemasangan.

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

     Output harus menampilkan file di jalur pemasangan OSS.

Konsol