Container Service for Kubernetes:Gunakan Volume Persisten Statis CPFS for Lingjun

Function Introduction

Dengan menggunakan add-on CSI, ACK memasang volume persisten statis CPFS for Lingjun ke workload melalui PV dan PVC. Add-on CSI secara otomatis memilih metode pemasangan optimal berdasarkan tipe node tempat pod dijadwalkan:

• Pemasangan VSC: Hanya didukung pada Node Lingjun. Anda harus mengajukan tiket ke produk CPFS dan produk Lingjun untuk mengaktifkan daftar putih.submit a ticket.

• Pemasangan VPC: Didukung pada node non-Lingjun. Buat Titik pemasangan VPC untuk mengaktifkan pemasangan. Semua node dalam VPC yang sama dapat memasang dan mengakses sistem file tersebut.

Prerequisites

• Tinjau Batasan untuk CPFS for Lingjun.

• Kluster Anda memenuhi kondisi berikut:

  • Versi kluster: 1.26 atau lebih baru. Untuk meningkatkan kluster Anda, lihat Manually upgrade a cluster.

  • Sistem operasi node: Alibaba Cloud Linux 3.

  • Anda telah menginstal komponen penyimpanan berikut pada versi yang diperlukan.

    Buka halaman Add-ons untuk memeriksa versi, menginstal, atau meningkatkan komponen.

    • Add-on CSI (csi-plugin dan csi-provisioner): v1.33.1 atau lebih baru. Untuk meningkatkan, lihat Manage CSI add-ons.

    • cnfs-nas-daemon add-on: 0.1.2 atau lebih baru.

      Perluas untuk melihat detail tentang cnfs-nas-daemon

      Add-on cnfs-nas-daemon mengelola proses EFC. Add-on ini mengonsumsi sumber daya signifikan dan secara langsung memengaruhi kinerja penyimpanan. Sesuaikan konfigurasi sumber dayanya di halaman Add-ons. Gunakan rekomendasi berikut:

      • CPU: Permintaan CPU meningkat seiring total bandwidth node. Alokasikan 0,5 core per 1 Gb/s bandwidth, ditambah 1 core tambahan untuk manajemen metadata. Sesuaikan pengaturan CPU menggunakan aturan ini.

        Contohnya, untuk node dengan NIC 100 Gb/s, atur permintaan CPU menjadi 100 * 0,5 + 1 = 51 core.

      • Memori: CPFS for Lingjun menggunakan FUSE. Caching baca/tulis data dan metadata file mengonsumsi memori. Atur permintaan memori menjadi 15% dari total memori node.

      Setelah menyesuaikan konfigurasi, sesuaikan sumber daya ke atas atau ke bawah secara dinamis berdasarkan workload aktual.

      Penting

      • Perilaku pembaruan: DaemonSet cnfs-nas-daemon menggunakan strategi pembaruan OnDelete secara default. Setelah mengubah pengaturan CPU atau memori di halaman Add-ons, hapus secara manual pod cnfs-nas-daemon yang ada di setiap node untuk memicu pembuatan ulang dan menerapkan pengaturan baru.

        Lakukan operasi ini selama jam sepi untuk memastikan stabilitas bisnis.

      • Risiko: Menghapus atau me-restart pod cnfs-nas-daemon akan mengganggu pemasangan CPFS sementara di node tersebut.

        • Node tanpa dukungan hot upgrade^①: Hal ini menyebabkan interupsi perangkat keras. Pod aplikasi gagal dan memerlukan penghapusan manual. Setelah dihapus, pod aplikasi akan restart dan pulih secara otomatis.

        • Node dengan dukungan hot upgrade^①: Pod aplikasi pulih secara otomatis setelah pod cnfs-nas-daemon di-restart.

        ① Node mendukung hot upgrade jika memenuhi semua kondisi berikut:

        • Versi kernel adalah 5.10.134-18 atau lebih baru.

        • Versi bmcpfs-csi-controller dan bmcpfs-csi-plugin adalah 1.35.1 atau lebih baru.

        • Versi cnfs-nas-daemon adalah 0.1.9-compatible.1 atau versi yang lebih baru.

    • Add-on bmcpfs-csi: Terdiri dari bmcpfs-csi-controller (komponen control-plane yang dikelola oleh ACK) dan bmcpfs-csi-node (komponen sisi node yang diterapkan sebagai DaemonSet di kluster).

Important Notes

• Saat menggunakan pemasangan VSC, node yang menjalankan pod harus berada di hpn-zone yang sama dengan instans sistem file CPFS for Lingjun.

• Node Lingjun harus dikaitkan dengan sistem file CPFS for Lingjun selama inisialisasi. Jika tidak, pemasangan CSI akan gagal.

• Sebelum mengambil offline Node Lingjun karena kegagalan, drain semua pod darinya. Melewatkan langkah ini menyebabkan metadata kluster tidak konsisten dan meninggalkan sumber daya pod yang tidak dapat dipulihkan.

• Anda tidak dapat memasang subdirektori berbeda dari instans CPFS yang sama ke satu pod menggunakan beberapa PV. Karena keterbatasan driver, konfigurasi ini menyebabkan pemasangan pod gagal dan mencegah pod dimulai.

  Sebagai gantinya, buat satu PV/PVC untuk instans CPFS. Lalu gunakan konfigurasi volumeMounts dalam spesifikasi pod Anda dan atur bidang subPath untuk memasang subdirektori yang diperlukan.

  subPath menggunakan mekanisme bind mount ringan. Mekanisme ini tidak menambahkan beban kinerja.

Step 1: Create a CPFS File System

1. Buat sistem file CPFS for Lingjun. Lihat Create a CPFS for Lingjun File System. Catat ID sistem file tersebut.

2. (Opsional) Jika Anda ingin memasang pada node non-Lingjun, buat Titik pemasangan VPC create a VPC mount target (dalam VPC yang sama dengan node kluster Anda), dan catat Nama domain titik pemasangan tersebut. Formatnya adalah cpfs-***-vpc-***.<Region>.cpfs.aliyuncs.com.

   Jika pod dijadwalkan ke Node Lingjun, pemasangan VSC digunakan secara default. Lewati langkah ini.

Step 2: Create a PV and a PVC

1. Buat PV dan PVC untuk sistem file CPFS yang sudah ada.

   1. Modifikasi contoh YAML di bawah ini dan simpan sebagai bmcpfs-pv-pvc.yaml.

      apiVersion: v1
      kind: PersistentVolume
      metadata:
        name: bmcpfs
      spec:
        accessModes:
        - ReadWriteMany
        capacity:
          storage: 10Ti
        claimRef:
          name: bmcpfs
          namespace: default
        csi:
          driver: bmcpfsplugin.csi.alibabacloud.com
          volumeAttributes:
             # Required if pods schedule to non-Lingjun nodes or cross-zone automatic VPC switching is enabled. Mounting fails otherwise.
            vpcMountTarget: cpfs-***-vpc-***.<Region>.cpfs.aliyuncs.com
            # If pods schedule to nodes in a different zone than the bmcpfs file system, use the vpcMountTarget to access CPFS.
            mountpointAutoSwitch: "true"
          # Replace volumeHandle with your CPFS for Lingjun file system ID.
          volumeHandle: bmcpfs-*****
        mountOptions: []
      
      ---
      apiVersion: v1
      kind: PersistentVolumeClaim
      metadata:
        name: bmcpfs
        namespace: default
      spec:
        accessModes:
        - ReadWriteMany
        resources:
          requests:
            storage: 10Ti
        volumeMode: Filesystem
        volumeName: bmcpfs

      • Parameter PV

        Parameter	Description
        accessModes	Mode akses untuk PV.
        capacity.storage	Kapasitas penyimpanan yang dideklarasikan. Deklarasi ini tidak memengaruhi kapasitas aktual.
        csi.driver	Tipe driver. Untuk CPFS for Lingjun, gunakan bmcpfsplugin.csi.alibabacloud.com.
        csi.volumeAttributes.vpcMountTarget	Nama domain Titik pemasangan VPC untuk CPFS. Meninggalkan ini kosong menyebabkan pemasangan gagal pada node non-Lingjun. Jangan atur ini jika pod dijadwalkan ke Node Lingjun.
        csi.volumeAttributes.mountpointAutoSwitch	Izinkan bmcpfs untuk beralih secara otomatis antara titik pemasangan VSC default dan titik pemasangan VPC yang ditentukan. Gunakan bersama csi.volumeAttributes.vpcMountTarget.
        csi.volumeHandle	ID sistem file CPFS.
        mountOptions	Opsi pemasangan.

      • Parameter PVC

        Parameter	Description
        accessModes	Mode akses yang diminta oleh PVC. Harus sesuai dengan PV.
        resources.requests.storage	Kapasitas penyimpanan yang dialokasikan ke pod. Tidak boleh melebihi kapasitas PV.
        volumeMode	Mode pemasangan. Atur ke Filesystem.
        volumeName	Nama PV yang akan di-bind ke PVC ini.

   2. Buat PV dan PVC.

      kubectl apply -f bmcpfs-pv-pvc.yaml

2. Konfirmasi bahwa PVC terikat ke PV.

   kubectl get pvc bmcpfs

   Output yang diharapkan:

   NAME     STATUS   VOLUME   CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGE
   bmcpfs   Bound    bmcpfs   10Ti       RWX                           <unset>                 51s

   Nilai STATUS adalah Bound. Pengikatan berhasil.

Step 3: Deploy an Application and Mount CPFS