All Products
Search

This Product

    Container Service for Kubernetes:Troubleshoot masalah penyimpanan ACK

    Document Center

    Container Service for Kubernetes:Troubleshoot masalah penyimpanan ACK

    Last Updated:Aug 22, 2026

    Atasi kegagalan startup pod dan masalah binding PVC untuk volume disk, NAS, dan OSS di kluster ACK.

    Prosedur diagnosa

    workflow

    Lakukan pemeriksaan berikut sebelum melakukan troubleshooting berdasarkan jenis penyimpanan.

    Langkah 1: Pastikan kegagalan terkait penyimpanan.

    Jalankan kubectl describe pods <pod-name> dan periksa bagian Events.

    Jika pod menunjukkan status di bawah ini, volume berhasil dimount. Kode keluar seperti CrashLoopBackOff pada tahap ini menunjukkan kesalahan aplikasi, bukan masalah penyimpanan.

    pod

    Langkah 2: Verifikasi plug-in CSI sedang berjalan.

    kubectl get pod -n kube-system | grep csi

    Output yang diharapkan:

    NAME                       READY   STATUS    RESTARTS   AGE
csi-plugin-***             4/4     Running   0          23d
csi-provisioner-***        7/7     Running   0          14d

    Jika salah satu pod tidak dalam status Running, jalankan kubectl describe pods <pod-name> -n kube-system untuk memeriksa alasan exit dan event-nya.

    Langkah 3: Verifikasi plug-in CSI telah diperbarui.

    kubectl get ds csi-plugin -n kube-system -oyaml | grep image

    Output yang diharapkan:

    image: registry.cn-****.aliyuncs.com/acs/csi-plugin:v*****-aliyun

    Bandingkan tag image dengan riwayat versi csi-plugin dan riwayat versi csi-provisioner.

    Jika versinya usang, upgrade CSI plug-in. Untuk kegagalan upgrade, lihat Troubleshoot kegagalan pembaruan komponen.

    Langkah 4: Troubleshoot masalah pod pending.

    Langkah 5: Mengatasi Masalah PVC Not Bound

    Troubleshoot kegagalan pembaruan komponen

    csi-provisioner

    csi-provisioner adalah Deployment dengan dua replika yang memiliki anti-afinitas pod lintas node.

    • Jika upgrade gagal, pastikan kluster memiliki minimal dua node yang dapat dijadwalkan (diperlukan untuk dua replika).

    • csi-provisioner versi 1.14 dan sebelumnya menggunakan StatefulSet. Jika StatefulSet bernama csi-provisioner masih ada, hapus dan instal ulang:

      kubectl delete sts csi-provisioner

      Kemudian masuk ke Container Service console dan instal ulang csi-provisioner dari Add-ons. Lihat Mengelola komponen.

    csi-plugin

    csi-plugin adalah DaemonSet yang dideploy di setiap node.

    • Periksa adanya node berstatus NotReady, yang menghambat upgrade DaemonSet.

    • Jika upgrade gagal tetapi semua plug-in berfungsi normal, pusat komponen mungkin mengalami timeout dan melakukan rollback.

    Troubleshooting disk

    Penting

    Node dan disk harus berada di wilayah dan zona yang sama. Tipe instans ECS yang berbeda mendukung tipe disk yang berbeda—lihat Instance family.

    Pod tidak berjalan (disk)

    Gejala

    Status PVC adalah Bound tetapi pod tidak Running.

    Kemungkinan penyebab dan penyelesaian

    Gejala dalam kubectl describe pods <pod-name> events

    Penyebab

    Penyelesaian

    0/N nodes are available: N node(s) didn't match Pod's node affinity/selector

    Tidak ada node yang dapat dijadwalkan tempat disk tersedia

    Jadwalkan pod ke node tempat disk tersedia. Lihat Menjadwalkan aplikasi ke node tertentu.

    MountVolume.SetUp failed for volume "..."

    Kesalahan mount disk

    Periksa event pod untuk mengetahui kesalahan spesifik. Untuk kesalahan mounting, lihat FAQ volume disk. Untuk kesalahan unmounting, lihat FAQ volume disk.

    InvalidDiskCategory.NotSupported atau kesalahan API ECS serupa

    Instans ECS tidak mendukung tipe disk tersebut

    Gunakan tipe disk yang didukung oleh instans ECS Anda. Lihat Instance family. Untuk kesalahan API ECS, lihat Kode kesalahan ECS.

    PVC tidak Bound (disk)

    Gejala

    Baik PVC maupun Pod tidak dalam status Running.

    Lokalisasi kesalahan

    Jalankan kubectl describe pvc <pvc-name> -n <namespace> dan periksa event untuk menentukan apakah ini masalah provisioning statis atau dinamis.

    Provisioning statis

    Selector PVC dan PV tidak cocok. Ketidakcocokan umum:

    • Selector PVC berbeda dari selector PV.

    • Keduanya mereferensikan nama StorageClass yang berbeda.

    • Status PV adalah Released.

    Periksa konfigurasi YAML PVC dan PV. Lihat Menggunakan volume disk statis.

    PV berstatus Released masih mereferensikan klaim sebelumnya dan tidak dapat di-bind ulang. Buat PV baru untuk meng-bind disk ke PVC baru.

    Provisioning dinamis

    csi-provisioner gagal membuat disk. Periksa event PVC untuk mengetahui kesalahan:

    Jenis kesalahan

    Referensi

    Kesalahan pembuatan disk

    FAQ volume disk

    Kesalahan ekspansi disk

    FAQ volume disk

    Kesalahan API ECS saat pembuatan disk

    ECS Error Center

    Troubleshooting NAS

    Penting

    • Node dan titik pemasangan NAS harus berada di Virtual Private Cloud (VPC) yang sama. Jika berada di VPC berbeda, hubungkan keduanya menggunakan Cloud Enterprise Network (CEN).

    • Mounting lintas zona didukung dalam VPC yang sama.

    • Direktori mount untuk Extreme NAS dan CPFS 2.0 harus diawali dengan /share.

    Pod tidak berjalan (NAS)

    Gejala

    Status PVC adalah Bound tetapi pod tidak Running.

    Kemungkinan penyebab dan penyelesaian

    Gejala dalam kubectl describe pods <pod-name> events

    Penyebab

    Lokalisasi kesalahan

    Penyelesaian

    Pod tetap dalam status Init dalam waktu lama; tidak ada pesan kesalahan eksplisit

    securityContext.fsGroup diatur dan volume berisi banyak file, menyebabkan chmod lambat

    Periksa apakah securityContext.fsGroup diatur dalam spesifikasi pod

    Hapus fsGroup dari spesifikasi pod, hapus pod, lalu biarkan pod restart untuk melakukan remount

    MountVolume.SetUp failed for volume "..." dengan timeout jaringan

    Port 2049 (NFS) diblokir di security group

    Periksa aturan security group untuk node

    Tambahkan aturan inbound untuk port TCP 2049. Lihat Menambahkan aturan security group.

    Titik pemasangan tidak dapat dijangkau; timeout koneksi dalam event

    Node dan NAS berada di VPC berbeda

    Verifikasi apakah VPC node dan VPC titik pemasangan NAS sesuai

    Pindahkan titik pemasangan NAS ke VPC yang sama dengan node, atau gunakan CEN untuk menghubungkan kedua VPC

    Event lainnya

    Kesalahan lainnya

    Periksa event pod dengan kubectl describe pods <pod-name>

    Lihat FAQ volume NAS.

    PVC tidak Bound (NAS)

    Gejala

    PVC tidak Bound dan pod tidak Running.

    Lokalisasi kesalahan

    Jalankan kubectl describe pvc <pvc-name> -n <namespace> dan periksa event untuk menentukan apakah ini masalah provisioning statis atau dinamis.

    Provisioning statis

    Selector PVC dan PV tidak cocok. Ketidakcocokan umum:

    • Konfigurasi selector berbeda antara PVC dan PV.

    • Keduanya mereferensikan nama StorageClass yang berbeda.

    • Status PV adalah Released.

    Periksa konfigurasi YAML PVC dan PV. Lihat Menggunakan volume NAS statis.

    PV berstatus Released tidak dapat digunakan kembali. Buat PV baru yang mengarah ke sistem file NAS.

    Provisioning dinamis

    csi-provisioner gagal menyediakan volume NAS. Periksa event PVC untuk mengetahui kesalahan. Lihat FAQ volume NAS.

    Troubleshooting OSS

    Penting

    • Memasang bucket OSS memerlukan kredensial AccessKey dalam PV, yang disediakan melalui Secret Kubernetes.

    • Gunakan titik akhir publik untuk akses cross-region; gunakan titik akhir internal untuk akses dalam wilayah yang sama.

    Pod tidak berjalan (OSS)

    Gejala

    Status PVC adalah Bound tetapi pod tidak Running.

    Kemungkinan penyebab dan penyelesaian

    Gejala dalam kubectl describe pods <pod-name> events

    Penyebab

    Lokalisasi kesalahan

    Penyelesaian

    Pod tetap dalam status Init dalam waktu lama; chmod lambat pada konten bucket

    securityContext.fsGroup diatur dan bucket berisi banyak file

    Periksa apakah securityContext.fsGroup diatur dalam spesifikasi pod

    Hapus fsGroup dari spesifikasi pod, hapus pod, lalu biarkan pod restart untuk melakukan remount

    MountVolume.SetUp failed for volume "..." dengan kesalahan koneksi

    Akses cross-region menggunakan titik akhir internal (private)

    Periksa apakah titik akhir bucket dalam PV adalah alamat private sementara node berada di wilayah berbeda

    Ubah titik akhir ke alamat publik bucket OSS

    Event lainnya

    Kesalahan lainnya

    Periksa event pod dengan kubectl describe pods <pod-name>

    Lihat FAQ volume OSS.

    PVC tidak Bound (OSS)

    Gejala

    PVC tidak Bound dan pod tidak Running.

    Lokalisasi kesalahan

    Jalankan kubectl describe pvc <pvc-name> -n <namespace> dan periksa event untuk menentukan apakah ini masalah provisioning statis atau dinamis.

    Provisioning statis

    Selector PVC dan PV tidak cocok. Ketidakcocokan umum:

    • Konfigurasi selector berbeda antara PVC dan PV.

    • Keduanya mereferensikan nama StorageClass yang berbeda.

    • Status PV adalah Released.

    Periksa konfigurasi YAML PVC dan PV. Lihat Menggunakan volume OSS statis.

    PV berstatus Released tidak dapat digunakan kembali. Ekstrak alamat bucket dan buat PV baru.

    Provisioning dinamis

    csi-provisioner gagal memasang bucket OSS. Periksa event PVC untuk mengetahui kesalahan. Lihat FAQ volume OSS.