Container Service for Kubernetes:Pasang bucket OSS menggunakan volume dinamis ossfs 1.0

1. Buat StorageClass

1. Buat Secret di namespace yang sama dengan aplikasi Anda.

   Ganti akId dan akSecret dengan ID AccessKey dan Rahasia AccessKey Anda.

   kubectl create secret generic oss-secret --from-literal='akId=<yourAccessKey ID>' --from-literal='akSecret=<yourAccessKey Secret>'

2. Buat StorageClass.

   1. Buat file bernama sc-oss.yaml.

      apiVersion: storage.k8s.io/v1
      kind: StorageClass
      metadata:
        name: sc-oss
      parameters:
        # Ganti dengan nama bucket OSS Anda.
        bucket: bucket
        # Ganti dengan wilayah bucket OSS Anda.
        region: cn-hangzhou
        # Jalur pemasangan relatif terhadap direktori root bucket. Anda dapat menentukan subdirektori.
        path: /
        # Titik akhir wilayah tempat bucket berada.
        url: "https://oss-cn-hangzhou-internal.aliyuncs.com" 
        # Nama Secret yang menyimpan informasi AccessKey.
        csi.storage.k8s.io/node-publish-secret-name: oss-secret
        # Namespace tempat Secret yang menyimpan informasi AccessKey berada.
        csi.storage.k8s.io/node-publish-secret-namespace: default
        # Parameter kustom.
        otherOpts: "-o umask=022 -o max_stat_cache_size=100000 -o allow_other"
        # Versi signature untuk permintaan yang dikirim ke server OSS.
        sigVersion: "v4"
      # Nilai tetap untuk plug-in CSI OSS Alibaba Cloud.
      provisioner: ossplugin.csi.alibabacloud.com
      # Kebijakan reclaim untuk persistent volume yang diprovisikan secara dinamis.
      reclaimPolicy: Retain
      # Mode pengikatan volume.
      volumeBindingMode: Immediate
      

      Parameter	Deskripsi
      name	Nama StorageClass.
      bucket	Bucket OSS yang akan dipasang.
      region	Saat menggunakan signature OSS v4, atur ini ke wilayah OSS tempat bucket berada. Untuk menanyakan wilayah OSS, lihat Tanyakan wilayah bucket. Saat parameter ini diatur, v4 secara otomatis digunakan sebagai versi signature OSS.
      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 seterusnya.
      url	Titik akhir bucket OSS yang akan dipasang. Gunakan titik akhir internal jika node pemasangan dan bucket berada di wilayah yang sama, atau jika koneksi VPC telah dibuat. Gunakan titik akhir publik jika node pemasangan dan bucket berada di wilayah berbeda. Berikut adalah format umum untuk port akses berbeda: Jaringan internal: https://oss-{{regionName}}-internal.aliyuncs.com. Format titik akhir internal vpc100-oss-{{regionName}}.aliyuncs.com sudah tidak digunakan lagi. Segera beralih ke format baru. Jaringan publik: https://oss-{{regionName}}.aliyuncs.com. Demi keamanan, kami merekomendasikan mengakses OSS melalui HTTPS. Untuk menggunakan HTTP, ganti awalan https:// pada format di atas dengan http://.
      csi.storage.k8s.io/node-publish-secret-name	Nama Secret yang menyimpan informasi AccessKey.
      csi.storage.k8s.io/node-publish-secret-namespace	Namespace tempat Secret yang menyimpan informasi AccessKey berada.
      otherOpts	Parameter kustom untuk persistent volume 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.
      provisioner	Jenis driver. Nilai ini tetap ossplugin.csi.alibabacloud.com saat menggunakan plug-in CSI OSS Alibaba Cloud.
      reclaimPolicy	Kebijakan reclaim untuk persistent volume yang diprovisikan secara dinamis. Persistent volume OSS hanya mendukung Retain, yang berarti saat Anda menghapus PVC, persistent volume yang sesuai dan data di bucket OSS tidak dihapus.
      volumeBindingMode	Mode pengikatan volume. Persistent volume OSS tidak memerlukan afinitas node berbasis zona ketersediaan. Anda dapat menggunakan nilai default Immediate.
      volumeAs	Mode akses volume. Nilai default adalah sharepath. Nilai yang valid: sharepath: Semua persistent volume berbagi jalur pemasangan yang sama. Data disimpan di <bucket>:<path>/. subpath: Membuat subdirektori khusus untuk setiap persistent volume untuk mengisolasi data. Data disimpan di <bucket>:<path>/<pv-name>/. Parameter ini hanya berlaku saat versi komponen CSI 1.31.3 atau lebih baru.
      sigVersion	Versi signature untuk permintaan yang dikirim ke server OSS. "v1" (Default): Menggunakan Signature Version 1 OSS. "v4" (Direkomendasikan): Menggunakan Signature Version 4 OSS.

   2. Buat StorageClass.

      kubectl apply -f sc-oss.yaml

1. Simpan AccessKey dari Langkah 1 sebagai Secret untuk persistent volume.

   1. Pada halaman ACK Clusters, klik nama kluster Anda. Di panel navigasi kiri, klik Configurations > Secrets.

   2. Klik Create from YAML dan ikuti petunjuk di layar untuk membuat Secret.

      apiVersion: v1
      kind: Secret
      metadata:
        name: oss-secret
        # Harus sesuai dengan namespace aplikasi.
        namespace: default
      stringData:
        # Ganti dengan ID AccessKey Anda.
        akId: <your AccessKey ID>
        # Ganti dengan rahasia AccessKey Anda.
        akSecret: <your AccessKey Secret>

2. Pada halaman Clusters, klik nama kluster Anda. Di panel navigasi kiri, klik Volumes > StorageClasses.

3. Pada halaman StorageClasses, klik Create, atur PV Type ke OSS, dan ikuti petunjuk di layar untuk mengonfigurasi StorageClass.

   Parameter	Deskripsi
   Access certificate	Secret yang digunakan untuk mengakses OSS, yang berisi ID AccessKey dan Rahasia AccessKey.
   Bucket ID:	Bucket OSS yang akan digunakan. Konsol hanya menampilkan bucket yang dapat diakses oleh AccessKey yang dikonfigurasi.
   OSS 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 seterusnya.
   Volume Mode	Mode akses volume. Default adalah Shared Directory. Nilai yang valid: Mode Subdirectory hanya berlaku saat versi komponen CSI 1.31.3 atau lebih baru. Jika tidak, mode Shared Directory yang digunakan. Shared Directory (sharepath): Semua persistent volume berbagi jalur pemasangan yang sama. Data disimpan di <bucket>:<path>/. Subdirectory (subpath): Membuat subdirektori khusus untuk setiap persistent volume untuk mengisolasi data. Data disimpan di <bucket>:<path>/<pv-name>/.
   Endpoint	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. Secara default, konsol menggunakan HTTP untuk mengakses OSS melalui jaringan internal. Untuk menggunakan HTTPS, Anda harus membuat PV menggunakan kubectl.
   Reclaim policy	Kebijakan reclaim untuk persistent volume yang diprovisikan secara dinamis. Persistent volume OSS hanya mendukung Retain, yang berarti saat Anda menghapus PVC, persistent volume yang sesuai dan data di bucket OSS tidak dihapus.
   Optional Parameters:	Parameter kustom untuk persistent volume 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.