k3s: ติดตั้ง Kubernetes ขนาดเล็กบน Cloud Server เครื่องเดียว

# Ubuntu / Debian (UFW)
sudo ufw allow 80,443/tcp
sudo ufw allow from 10.42.0.0/16 to any
sudo ufw allow from 10.43.0.0/16 to any

# AlmaLinux / Rocky Linux 9 (firewalld)
sudo firewall-cmd --permanent --add-service=http --add-service=https
sudo firewall-cmd --permanent --zone=trusted --add-source=10.42.0.0/16
sudo firewall-cmd --permanent --zone=trusted --add-source=10.43.0.0/16
sudo firewall-cmd --reload

curl -sfL https://get.k3s.io | sh -
sudo systemctl status k3s --no-pager
sudo k3s kubectl get nodes

mkdir -p ~/.kube
sudo cp /etc/rancher/k3s/k3s.yaml ~/.kube/config
sudo chown "$(id -u):$(id -g)" ~/.kube/config
chmod 600 ~/.kube/config
echo 'export KUBECONFIG=$HOME/.kube/config' >> ~/.bashrc
source ~/.bashrc
kubectl get nodes

ขั้นตอนที่ 4: Deploy แอปตัวอย่าง

สร้างไฟล์ hello.yaml ที่มี Deployment สองสำเนาและ Service ภายใน การกำหนด resources สำคัญมากบนเครื่องเดียว เพราะป้องกันไม่ให้แอปตัวหนึ่งกิน RAM จนระบบทั้งเครื่องล่ม

apiVersion: apps/v1
kind: Deployment
metadata:
  name: hello
spec:
  replicas: 2
  selector:
    matchLabels:
      app: hello
  template:
    metadata:
      labels:
        app: hello
    spec:
      containers:
        - name: web
          image: nginx:1.27-alpine
          ports:
            - containerPort: 80
          resources:
            requests: { cpu: 50m, memory: 32Mi }
            limits: { memory: 128Mi }
---
apiVersion: v1
kind: Service
metadata:
  name: hello
spec:
  selector:
    app: hello
  ports:
    - port: 80
      targetPort: 80

kubectl apply -f hello.yaml
kubectl get pods -o wide

ขั้นตอนที่ 5: เปิดให้เข้าจากภายนอกด้วย Traefik Ingress

k3s ติดตั้ง Traefik เป็น Ingress Controller ที่ฟังพอร์ต 80 และ 443 ของเครื่องไว้แล้ว เพิ่ม Ingress ต่อท้าย hello.yaml เพื่อบอกว่าคำขอที่มาด้วยชื่อ app.example.com ให้ส่งไป Service hello

---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: hello
spec:
  ingressClassName: traefik
  rules:
    - host: app.example.com
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: hello
                port:
                  number: 80

kubectl apply -f hello.yaml
kubectl get ingress
curl -s -H 'Host: app.example.com' http://203.0.113.10/ | grep -i '<title>'

ผลลัพธ์ควรเป็น <title>Welcome to nginx!</title> สำหรับ HTTPS แบบอัตโนมัติ ให้ติดตั้ง cert-manager เพิ่ม แล้วระบุ tls ใน Ingress

ขั้นตอนที่ 6: ดูแลประจำวันและสำรองข้อมูลคลัสเตอร์

kubectl logs deploy/hello --tail=50
kubectl scale deploy/hello --replicas=3
kubectl set image deploy/hello web=nginx:1.27.5-alpine
kubectl rollout status deploy/hello
kubectl rollout undo deploy/hello

คลัสเตอร์ k3s เครื่องเดียวเก็บสถานะไว้ใน SQLite ที่ /var/lib/rancher/k3s/server/db/ และต้องใช้ Token ที่ /var/lib/rancher/k3s/server/token คู่กันตอนกู้คืน การหยุด Service k3s ชั่วคราวไม่หยุด Container ที่รันอยู่ จึงสำรองได้โดยแอปไม่ล่ม

sudo systemctl stop k3s
sudo tar czf /root/k3s-backup-$(date +%F).tar.gz \
  /var/lib/rancher/k3s/server/db /var/lib/rancher/k3s/server/token
sudo systemctl start k3s

ข้อมูลใน PersistentVolume ของ StorageClass local-path อยู่ใต้ /var/lib/rancher/k3s/storage ต้องสำรองแยก ถ้าต้องการลบ k3s ทั้งหมด ใช้ /usr/local/bin/k3s-uninstall.sh (ลบข้อมูลคลัสเตอร์ทั้งหมด)

ปัญหาที่พบบ่อยเกี่ยวกับ k3s

รัน kubectl แล้วขึ้น permission denied หรือ connection refused ต้องทำอย่างไร?

ถ้าเป็น permission denied แปลว่า kubectl พยายามอ่าน /etc/rancher/k3s/k3s.yaml ที่อ่านได้เฉพาะ root ให้ตั้ง KUBECONFIG ตามขั้นตอนที่ 3 ถ้าเป็น connection refused ให้ตรวจว่า Service ทำงานด้วย sudo systemctl status k3s และดู Log ด้วย sudo journalctl -u k3s -n 50

Pod ค้างสถานะ Pending หรือ ImagePullBackOff เกิดจากอะไร?

ใช้ kubectl describe pod ชื่อพ็อด ดูส่วน Events ท้ายผลลัพธ์ Pending มักเป็นเพราะ requests ของ CPU หรือ RAM เกินที่เครื่องเหลือ ImagePullBackOff คือชื่อ Image หรือ Tag ผิด หรือ Registry ต้องการรหัสผ่าน

Pod ติดต่อกันหรือหา DNS ไม่ได้หลังเปิด Firewall แก้อย่างไร?

ตรวจว่ามีกฎอนุญาต 10.42.0.0/16 และ 10.43.0.0/16 ตามขั้นตอนที่ 1 ครบ อาการที่พบบ่อยคือ coredns หรือ metrics-server รีสตาร์ตวนซ้ำ เพราะคุยกับ API Server บนโฮสต์ไม่ได้

k3s ใช้ทำงานจริง (Production) ได้หรือไม่?

ได้ k3s เป็น Kubernetes ที่ผ่านการรับรองความเข้ากันได้ แต่คลัสเตอร์หนึ่งโหนดไม่มีความพร้อมใช้งานสูง งานจริงควรมีอย่างน้อยสามโหนด Server ใช้ Embedded etcd หรือฐานข้อมูลภายนอก และเก็บฐานข้อมูลของแอปไว้นอกคลัสเตอร์

ถ้าต้องการวางคลัสเตอร์ k3s หลายโหนดบน Cloud Server หรือประเมินว่างานของคุณควรใช้ Kubernetes หรือไม่ ติดต่อทีมงาน THAI DATA CLOUD อ่านเอกสารทางการได้ที่ K3s Documentation

อ่านเพิ่มเติมเกี่ยวกับ k3s

• คู่มือ UFW ของ Ubuntu
• Caddy: เว็บเซิร์ฟเวอร์ที่ทำ HTTPS ให้อัตโนมัติบน Linux
• คู่มือการใช้งานทั้งหมดของ THAI DATA CLOUD