5 Lỗi Phổ biến khi cài đặt Kubernetes và cách khắc phục

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
spec:
  containers:
    - name: my-container
      image: nginx:1.25
      ports:
        - containerPort: 80

Bài viết có liên quan 10 Cách bảo mật Kubernetes hiệu quả nhất để ngăn chặn tấn công

Service không truy cập được

Mô tả:
Trong quá trình triển khai ứng dụng, mặc dù Pod đã chạy ổn định nhưng người dùng không thể truy cập ứng dụng thông qua Service. Điều này thường khiến nhiều người nhầm lẫn rằng ứng dụng bị lỗi, trong khi vấn đề nằm ở cấu hình của Service hoặc sự kết nối giữa Service và Pod.

Nguyên nhân phổ biến:
Một số nguyên nhân thường gặp dẫn đến việc không thể truy cập được ứng dụng qua Service gồm:

• Sai cấu hình port hoặc selector: Cổng khai báo trong Service không đúng với cổng mà container đang lắng nghe, hoặc selector không đúng khiến Service không tìm được Pod tương ứng để chuyển tiếp lưu lượng.
• Pod chưa sẵn sàng hoặc chưa được gắn đúng label: Dù Pod đang chạy, nhưng nếu chưa sẵn sàng (not Ready) hoặc thiếu label tương ứng với selector trong Service thì Service cũng không thể định tuyến lưu lượng đến Pod đó.

Cách khắc phục:

1. Kiểm tra trạng thái Service

Sử dụng các lệnh sau để xem chi tiết về Service và xác nhận có Endpoint nào được gán:

kubectl get svc kubectl describe svc <service-name>

Nếu trong phần mô tả không có Endpoints, tức là Service không tìm thấy Pod phù hợp để liên kết.

• 2. Đảm bảo selector khớp với label của Pod

Kiểm tra lại phần selector trong cấu hình Service và so sánh với labels mà Pod đang sử dụng. Cần đảm bảo chúng hoàn toàn khớp nhau. Ví dụ:

selector:
app: my-app

Phải tương ứng với:

labels: app: my-app

• 3. Kiểm tra cấu hình port mapping
  Đảm bảo rằng các trường port, targetPort trong Service và containerPort trong Pod được khai báo đúng. Một sai lệch nhỏ ở đây cũng có thể khiến Service không hoạt động như mong muốn. Ví dụ:

ports:
- port: 80
targetPort: 8080

Trong đó targetPort phải đúng với containerPort trong cấu hình container.

Bài viết liên quan: Managed Kubernetes: Bước đi mới cho điều phối container

Volume không mount được

Mô tả:

Khi khởi chạy Pod, bạn nhận được thông báo lỗi liên quan đến việc không thể gắn kết volume. Pod có thể bị kẹt ở trạng thái Pending, hoặc khởi động nhưng container bị lỗi và không thể truy cập vào dữ liệu lưu trữ. Đây là lỗi phổ biến khi làm việc với PersistentVolume (PV) và PersistentVolumeClaim (PVC) trong Kubernetes.

Nguyên nhân phổ biến:

• PVC chưa được bind: Khi PVC không được liên kết (bind) với một PersistentVolume, Pod không thể sử dụng volume đó.
• StorageClass không tồn tại hoặc sai cấu hình: Nếu PVC khai báo một StorageClass không đúng hoặc không tồn tại trong cụm Kubernetes, quá trình tạo volume sẽ thất bại, dẫn đến lỗi mount.

Cách khắc phục:

1. Kiểm tra PVC

Sử dụng lệnh sau để kiểm tra trạng thái PVC:

kubectl get storageclass

Nếu trạng thái là Pending, nghĩa là PVC chưa được bind với bất kỳ PersistentVolume nào. Bạn cần kiểm tra xem có PV nào phù hợp (về dung lượng, accessMode, StorageClass…) để phục vụ PVC hay không.

• 2. Đảm bảo StorageClass tồn tại và đúng định dạng

Kiểm tra StorageClass được khai báo trong PVC có tồn tại trong cụm hay không:

kubectl get storageclass

Nếu tên StorageClass không nằm trong danh sách, bạn cần chỉnh sửa lại YAML hoặc tạo mới StorageClass tương ứng. Đồng thời, kiểm tra xem StorageClass có cấu hình đúng backend (VD: hostPath, NFS, CSI plugin…) và hỗ trợ dynamic provisioning hay không.