Container Service for Kubernetes：Pasang Bucket OSS menggunakan volume penyediaan dinamis ossfs 1.0

1. Buat StorageClass

1. Buat secret. Namespace secret harus sama dengan namespace aplikasi Anda.

   Ganti <yourAccessKey ID> dan <yourAccessKey Secret> dengan ID AccessKey dan Rahasia AccessKey yang telah Anda peroleh.

   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 aktual Anda.
        bucket: bucket
        # Direktori root atau subdirektori tertentu dari bucket yang akan dipasang.
        path: /
        # Titik akhir wilayah tempat bucket berada.
        url: "http://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"
      # Nilai ini tetap ketika Anda menggunakan plug-in CSI OSS Alibaba Cloud.
      provisioner: ossplugin.csi.alibabacloud.com
      # Kebijakan reclaim untuk PV yang disediakan secara dinamis.
      reclaimPolicy: Retain
      # Mode pengikatan.
      volumeBindingMode: Immediate
      

      Parameter	Deskripsi
      name	Nama StorageClass.
      bucket	Bucket OSS yang akan dipasang.
      path	Memerlukan 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 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 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.
      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	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.
      provisioner	Jenis driver. Nilai ini tetap ossplugin.csi.alibabacloud.com saat Anda menggunakan plug-in CSI OSS Alibaba Cloud.
      reclaimPolicy	Kebijakan reclaim untuk PV yang disediakan secara dinamis. Volume persisten OSS saat ini hanya mendukung Retain. Artinya, saat Anda menghapus PVC, PV dan data di Bucket OSS tidak dihapus.
      volumeBindingMode	Mode asosiasi. Volume persisten OSS tidak memerlukan afinitas node berbasis zona. Anda dapat menggunakan nilai default Immediate.
      volumeAs	Mode akses volume. Nilai default-nya adalah sharepath. Nilai yang valid: subpath hanya berlaku jika versi komponen CSI 1.31.3 atau lebih baru. Jika tidak, sharepath yang digunakan. sharepath: Memasang dalam mode bersama. Semua volume berbagi jalur pemasangan. Data disimpan di <bucket>:<path>/. subpath: Memasang dalam mode subdirektori. Subdirektori dibuat otomatis di bawah jalur pemasangan saat volume dibuat. Data disimpan di <bucket>:<path>/<pv-name>/.
      sigVersion	Versi signature untuk permintaan 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 yang Anda peroleh di Langkah 1 sebagai secret untuk digunakan oleh PV.

   1. Pada halaman Clusters, klik nama kluster yang ingin diubah. Di panel navigasi kiri, pilih Configurations > Secrets.

   2. Klik Create from YAML, ikuti petunjuk di layar untuk membuat secret.

      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>

2. Pada halaman Clusters, temukan kluster yang diinginkan dan klik namanya. Di panel kiri, pilih Volumes > StorageClasses.

3. Pada halaman StorageClasses, klik Create. Atur PV Type ke OSS dan konfigurasikan parameter StorageClass sesuai petunjuk.

   Item Konfigurasi	Deskripsi
   Access Certificate	Konfigurasikan secret yang diperlukan untuk mengakses OSS. Ini adalah ID AccessKey dan Rahasia AccessKey yang telah Anda peroleh.
   Bucket ID	Bucket OSS yang akan digunakan. Hanya bucket yang dapat diakses dengan AccessKey yang dikonfigurasi yang ditampilkan di sini.
   OSS Path	Memerlukan 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 selanjutnya.
   Volume Mode	Mode akses volume. Mode default-nya adalah Shared Directory. Nilai yang valid: Subdirectory hanya berlaku jika versi komponen CSI 1.31.3 atau lebih baru. Jika tidak, mode Shared Directory yang digunakan. Shared Directory (sharepath): Semua volume berbagi jalur pemasangan. Data disimpan di <bucket>:<path>/. Subdirectory (subpath): Subdirektori dibuat otomatis di bawah jalur pemasangan saat volume dibuat. 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 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. Saat Anda mengakses melalui jaringan internal, protokol HTTP digunakan secara default. Untuk menggunakan HTTPS, gunakan metode kubectl.
   Reclaim Policy	Kebijakan reclaim untuk PV yang disediakan secara dinamis. Volume persisten OSS saat ini hanya mendukung Retain. Artinya, saat Anda menghapus PVC, PV dan data di Bucket OSS tidak dihapus.
   Optional Parameters	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.