Chạy k3s một node trên VPS có đáng không?
k3s dùng Kubernetes API thật trên một VPS, tốn bao nhiêu RAM, vì sao port 80 có thể xung đột khi cài và khi nào Docker Compose vẫn hợp lý hơn.
k3s là gì và một node k3s cung cấp cho bạn những gì
k3s là một bản phân phối Kubernetes đầy đủ được đóng gói thành một binary duy nhất. Chạy k3s trên một VPS duy nhất giúp bạn có Kubernetes API thực sự mà không cần control plane gồm ba máy. Đây là một bản phân phối Kubernetes được chứng nhận, nên manifest áp dụng được ở đây cũng có thể áp dụng cho một cluster managed sau này. Cài đặt chỉ cần một command và mất khoảng một phút. Đổi lại, bạn phải dành một phần memory, khiến phần memory đó không còn cho các ứng dụng, đồng thời phải xử lý một số failure mode không bao giờ xảy ra với Docker Compose.
SUSE xây dựng k3s cho các site edge và những hệ thống cài đặt nhỏ. Các khác biệt của k3s so với Kubernetes upstream nhằm làm cho k3s nhỏ hơn và dễ vận hành hơn. Datastore mặc định là sqlite thông qua một shim có tên kine, không phải etcd, nên bạn không phải duy trì etcd quorum. containerd được nhúng trong binary thay vì cài riêng. Binary này cũng tích hợp CoreDNS cho cluster DNS, Traefik làm ingress controller, ServiceLB (còn gọi là klipper-lb) để các service LoadBalancer hoạt động mà không cần cloud provider phía sau, local-path provisioner cho persistent volume, metrics-server và flannel cho pod networking. Tất cả các thành phần này đều khởi động theo mặc định. Các thiết lập mặc định đó đặt Traefik trên các cổng 80 và 443. Vì vậy, trước khi cài trên một VPS đang phục vụ dịch vụ khác, hãy quyết định dịch vụ nào được dùng các cổng này.
Khi nào chỉ một node k3s là lựa chọn phù hợp
Hãy dùng quy tắc này. Chạy k3s khi thứ bạn cần là Kubernetes API: bạn đang học Kubernetes trên một máy do mình quản lý, hoặc phần mềm bạn muốn chỉ cung cấp Helm chart. Khả năng chuyển manifest cũng là một lợi ích, vì Deployment bạn viết ở đây có thể chuyển sang managed cluster mà không cần thay đổi. Chạy Docker Compose khi thứ bạn cần là các ứng dụng. Compose khởi chạy cùng các container với ít thành phần phải quản lý hơn nhiều, và Compose file trên VPS dễ đọc lại sau một năm hơn là một thư mục chứa các manifest.
Hãy hiểu rõ những gì một node không cung cấp.
- Không có high availability. Khi VPS reboot, mọi workload đều dừng. Kubernetes sẽ reschedule pod sang node khác, nhưng ở đây không có node nào khác.
- Không có rolling update giúp service tiếp tục hoạt động, trừ khi ứng dụng hỗ trợ chạy 2 replica trên cùng một máy và node còn đủ tài nguyên cho cả hai.
- Storage bị gắn với máy đó, vì lý do được mô tả trong phần local-path bên dưới.
- Control plane tiêu tốn khoảng một gigabyte RAM dù bạn có deploy gì hay không.
Không điều nào trong số đó khiến k3s trở thành lựa chọn tồi. Nhưng chúng khiến k3s trở thành lựa chọn tồi nếu lý do là điều mọi người thường đưa ra: reliability. Nếu điều bạn thực sự cần là nhiều máy để xây dựng một cluster nhiều node thực sự, hãy quyết định việc đó trước: Proxmox trên phần cứng của bạn so với VPS thuê sẽ xác định các node đến từ đâu, trước khi k3s xác định những gì chạy trên đó.
Chi phí RAM và CPU của k3s trước khi bạn triển khai bất kỳ thứ gì
Dự án k3s công bố các số liệu đã đo thay vì các con số ước tính. Hãy đọc kỹ, vì con số mọi người thường trích dẫn không phải mức tiêu thụ của k3s khi idle.
Dữ liệu đằng sau biểu đồ này
[
{
"label": "Server, sqlite datastore",
"ram_mb": "1,596",
"cpu_percent_of_one_core": 6
},
{
"label": "Server, embedded etcd",
"ram_mb": "1,606",
"cpu_percent_of_one_core": 6
},
{
"label": "Agent node only",
"ram_mb": "275",
"cpu_percent_of_one_core": 3
}
]Một server node trong bài kiểm thử đó dùng 1,596 MB RAM ở percentile 95 và khoảng 6 phần trăm của một core. Đây là số liệu do dự án công bố, không phải số đo từ hướng dẫn này. Bài kiểm thử chạy k3s v1.26.5 với tất cả component đi kèm được bật, cùng một stack monitoring gồm Prometheus và Grafana. Vì vậy cluster đang có tải thay vì ở trạng thái trống. Tuy nhiên, dự án cho biết các số liệu này chỉ bao gồm Kubernetes datastore và control plane, không bao gồm yêu cầu riêng của workload. Các container của bạn sẽ dùng thêm tài nguyên. Khi thay sqlite bằng embedded etcd, mức dùng tăng lên 1,606 MB. Một agent node, chạy kubelet và containerd nhưng không có control plane, dùng 275 MB. Mức tối thiểu được ghi nhận cho một server là 2 core và 2 GB RAM. Mức này chỉ đủ cho k3s và các component đi kèm trước khi chạy workload của bạn.
Cách hiểu thực tế là: trên một VPS 2 GB, control plane và các add-on đi kèm sẽ để lại rất ít tài nguyên. Khi thiếu memory, kubelet sẽ evict pod. Nhưng nếu mức dùng memory tăng nhanh, OOM killer của kernel có thể hoạt động trước khi kubelet phát hiện tình trạng thiếu memory. 4 GB là mức sàn tương đối thoải mái cho một node chạy vài service nhỏ. Hãy tự đo trên máy của bạn thay vì tin vào bất kỳ số liệu công bố nào, kể cả số liệu trong phần này.
free -h
sudo k3s kubectl top node
sudo k3s kubectl get pods -AHãy chạy free -h trước khi cài đặt và chạy lại sau khi mọi pod trong kube-system có trạng thái Running. Chênh lệch giữa hai lần đo là chi phí của control plane trên phần cứng của bạn. k3s kubectl top node trả về error: Metrics API not available trong một hoặc hai phút đầu sau khi cài đặt, vì metrics-server chưa scrape dữ liệu nào. Đây không phải lỗi. Nếu bạn dùng một máy cho việc này và các workload khác cùng lúc, cách tính trong tính RAM và CPU cho VPS vẫn áp dụng nguyên trạng.
Cài k3s cố định theo một release, không dùng bản latest
Dòng lệnh quick start mà mọi người thường sao chép sẽ cài phiên bản mà stable channel trỏ đến tại thời điểm bạn chạy lệnh. Với máy chủ dự định sử dụng lâu dài, hãy cố định phiên bản. k3s cung cấp một channel cho từng phiên bản minor của Kubernetes, vì vậy INSTALL_K3S_CHANNEL=v1.36 sẽ theo các bản patch trong v1.36 và không tự chuyển sang phiên bản minor khác. Tính đến tháng 10 năm 2026, stable channel trỏ đến v1.36.5+k3s1.
Trước tiên, hãy tạo file cấu hình rồi mới cài đặt. k3s đọc /etc/rancher/k3s/config.yaml khi khởi động, vì vậy mọi thiết lập trong file này đều áp dụng cho lần boot đầu tiên và mọi lần boot sau đó.
sudo mkdir -p /etc/rancher/k3s
sudo tee /etc/rancher/k3s/config.yaml >/dev/null <<'EOF'
tls-san:
- k3s.example.com
EOF
curl -sfL https://get.k3s.io | INSTALL_K3S_CHANNEL=v1.36 sh -Để cố định một release cụ thể thay vì một channel, hãy dùng INSTALL_K3S_VERSION=v1.36.5+k3s1. Dấu cộng là một phần của tag. Sau đó kiểm tra xem k3s đã khởi động thành công chưa.
k3s --version
sudo systemctl status k3s
sudo k3s kubectl get node
sudo k3s kubectl get pods -Akubectl get node phải liệt kê một node có STATUS Ready trong khoảng 30 giây. Mọi pod trong kube-system cũng phải chuyển sang trạng thái Running hoặc Completed. Nếu node bị kẹt ở NotReady, thường là do container runtime chưa khởi động, vì vậy hãy đọc sudo journalctl -u k3s -n 100 --no-pager. Trên image VPS bất thường, hãy chạy sudo k3s check-config trước khi debug các vấn đề khác: lệnh này báo cáo các kernel feature còn thiếu, nhanh hơn nhiều so với việc đọc log.
Vì sao cổng 80 đã được sử dụng và cần nhường gì để khắc phục
Đây là lỗi thường gặp trên VPS đã chạy sẵn một dịch vụ. Quá trình cài đặt thành công, nhưng Traefik không bao giờ nhận được địa chỉ nếu một Kubernetes pod khác đã giữ cùng hostPort trên node duy nhất.
Cơ chế hoạt động như sau: chart Traefik đi kèm tạo một Service kiểu LoadBalancer trên các cổng 80 và 443. ServiceLB đáp ứng yêu cầu đó bằng cách tạo một DaemonSet gồm các pod nhỏ, có tên bắt đầu bằng tiền tố svclb-, rồi claim các số cổng đó dưới dạng hostPort trên mỗi node. hostPort chuyển tiếp traffic từ cổng của node đến pod thông qua các network rule. Scheduler kiểm tra các host port được Kubernetes pod khai báo, không kiểm tra socket do host service hoặc Docker container độc lập đang giữ. Một pod khác reserving cùng hostPort sẽ chặn việc scheduling; nginx, Caddy, Apache hoặc một Docker container độc lập đang listen trên cổng 80 tự nó không gây ra lỗi từ chối scheduling này.
sudo k3s kubectl -n kube-system get pods
sudo k3s kubectl -n kube-system get svc traefik
sudo ss -lntp '( sport = :80 or sport = :443 )'Khi một Kubernetes pod khác đang giữ hostPort gây xung đột, bạn sẽ thấy svclb pod ở trạng thái Pending và service không có địa chỉ bên ngoài:
svclb-traefik-8f2c1a-r6k9x 0/2 Pending 0 3m
traefik LoadBalancer 10.43.62.11 <pending> 80:31480/TCP,443:30219/TCPChạy kubectl -n kube-system describe pod svclb-traefik-... sẽ hiển thị trực tiếp nguyên nhân:
0/1 nodes are available: 1 node(s) didn't have free ports for the requested pod ports.ss -lntp cho biết process nào đang listen trên cổng; lệnh này không hiển thị các hostPort reservation mà scheduler kiểm tra. Có nhiều cách xử lý, và mỗi cách đều có đánh đổi.
Dành các cổng cho k3s. Xóa mọi hostPort reservation gây xung đột khỏi các Kubernetes pod khác, đồng thời stop và disable web server hiện có trên host để Traefik xử lý traffic đến trên cổng 80 và 443. Đây là lựa chọn phù hợp khi VPS sẽ chỉ dùng làm máy chủ k3s và mọi dịch vụ bạn đang chạy sẽ được chuyển ra sau Ingress.
Disable ServiceLB và giữ proxy hiện có. Cài đặt bằng --disable=servicelb. Service kiểu LoadBalancer vẫn allocate một NodePort, vì vậy Traefik vẫn có thể truy cập qua một cổng cao như 31480, còn nginx hoặc Caddy của bạn sẽ proxy đến 127.0.0.1:31480. Đổi lại, bạn không có địa chỉ bên ngoài: service sẽ luôn báo <pending>. Điều này trông giống lỗi, nhưng thực tế là lựa chọn bạn đã chủ động cấu hình.
Disable Traefik và định tuyến bằng proxy riêng. Cài đặt bằng --disable=traefik. Khi đó bạn không có ingress controller, nên các Ingress object hoàn toàn không có tác dụng: chúng chỉ nằm trong API và không có controller nào watch. Cách này phù hợp khi bạn định tuyến từ host proxy đến các NodePort, và là lựa chọn rõ ràng nếu bạn đã biết muốn xử lý HTTP như thế nào. Nếu chưa quyết định thành phần nào sẽ đứng phía trước, hãy xem lựa chọn giữa nginx, Caddy và Traefik làm reverse proxy trước khi disable bất kỳ thành phần nào.
Cả hai flag đều phải được đặt trên installer hoặc trong file cấu hình:
tls-san:
- k3s.example.com
disable:
- traefik
- servicelbBạn cũng có thể sửa file đó sau khi cài đặt rồi chạy sudo systemctl restart k3s, vì --disable không chỉ bỏ qua một component tại thời điểm cài đặt. Lệnh này còn xóa component đã được deploy, nên thay đổi sẽ có hiệu lực trên cluster đang chạy.
Để giữ Traefik nhưng thay đổi cách cấu hình chart, không sửa /var/lib/rancher/k3s/server/manifests/traefik.yaml. k3s sẽ ghi đè file đó bằng các giá trị mặc định mỗi lần khởi động. Thay vào đó, hãy thêm một file riêng trong cùng thư mục, vì mọi nội dung trong /var/lib/rancher/k3s/server/manifests sẽ được tự động áp dụng lúc startup và mỗi khi file đó thay đổi trên disk.
apiVersion: helm.cattle.io/v1
kind: HelmChartConfig
metadata:
name: traefik
namespace: kube-system
spec:
valuesContent: |-
ports:
web:
forwardedHeaders:
trustedIPs:
- 10.0.0.0/8Ví dụ này đặt một giá trị của Traefik chart: các địa chỉ proxy được tin cậy. Cơ chế tương tự có thể đặt mọi giá trị khác mà chart cung cấp, bao gồm cả các cổng của nó.
Lưu trữ bền vững trên một node
k3s phát hành một StorageClass mặc định có tên local-path, sử dụng local-path provisioner của Rancher. PersistentVolumeClaim không chỉ định storageClassName sẽ dùng StorageClass này. Các volume nằm trong /var/lib/rancher/k3s/storage, mỗi volume có một thư mục con riêng trên đĩa của chính node đó.
sudo k3s kubectl get storageclass
sudo k3s kubectl get pvc -A
sudo ls -l /var/lib/rancher/k3s/storageCó 2 hệ quả từ việc volume nằm “trên đĩa của chính node đó”, và cả 2 thường gây vấn đề về sau chứ không phải ngay hôm nay.
StorageClass này dùng volumeBindingMode: WaitForFirstConsumer, nên PVC mới vẫn ở trạng thái Pending cho đến khi một pod thực sự mount nó. kubectl describe pvc sẽ in ra:
waiting for first consumer to be created before bindingĐây là hành vi bình thường. Vì vậy, chỉ tạo PVC rồi chờ sẽ không bao giờ làm trạng thái này thay đổi.
Sau khi được bind, volume có node affinity trỏ đến node đã tạo volume. Affinity này buộc mọi pod sử dụng claim đó chạy trên node này trong suốt vòng đời của volume. Với một node, bạn sẽ không nhận ra vấn đề. Khi thêm node thứ 2, một pod không chịu chuyển node có thể trông giống lỗi của scheduler cho đến khi bạn chạy kubectl get pv -o yaml và phát hiện hostname nằm trong nodeAffinity.
Bạn phải tự quản lý backup. Việc rebuild VPS sẽ xóa thư mục đó, và script uninstall bên dưới cũng vậy. Hãy backup /var/lib/rancher/k3s/storage, cùng với thư mục datastore sqlite /var/lib/rancher/k3s/server/db/ được sao chép khi service đã dừng vì đây là một database đang hoạt động, và file server token tại /var/lib/rancher/k3s/server/token. Token là bắt buộc: tài liệu k3s nêu rõ bạn phải khôi phục file đó hoặc truyền giá trị của nó cho --token khi khôi phục datastore từ backup. Lựa chọn khác là xem cluster như tạm thời và lưu mọi manifest trong git.
Ingress và TLS
Khi Traefik vẫn được bật, bạn chỉ cần một Ingress object tiêu chuẩn.
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: hello
annotations:
cert-manager.io/cluster-issuer: letsencrypt
spec:
ingressClassName: traefik
tls:
- hosts:
- hello.example.com
secretName: hello-tls
rules:
- host: hello.example.com
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: hello
port:
number: 80Certificate không tự xuất hiện. Cách thông dụng là cài cert-manager từ manifest được công bố, rồi tạo một ClusterIssuer. Phiên bản v1.21.3, phát hành ngày 23 October 2026, là phiên bản hiện tại tính đến October 2026.
sudo k3s kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.21.3/cert-manager.yamlapiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
name: letsencrypt
spec:
acme:
email: you@example.com
server: https://acme-v02.api.letsencrypt.org/directory
privateKeySecretRef:
name: letsencrypt-account-key
solvers:
- http01:
ingress:
ingressClassName: traefikHTTP-01 challenge yêu cầu máy chủ ACME (automatic certificate management environment) kết nối đến http://hello.example.com/.well-known/acme-challenge/... từ Internet công cộng. Vì vậy, bản ghi DNS của hostname, là bản ghi A hoặc bản ghi AAAA nếu VPS có thể truy cập qua IPv6, phải trỏ sẵn đến VPS và port 80 phải chuyển được đến Traefik. Khi tồn tại cả hai địa chỉ, Let's Encrypt thử địa chỉ IPv6 trước nhưng chuyển sang IPv4 nếu kết nối IPv6 ban đầu bị timeout. Các lỗi khác, gồm cả challenge response sai, không kích hoạt việc chuyển sang IPv4; request bị redirect cũng không được retry. Hãy sửa hoặc xóa bản ghi AAAA cũ. Nếu bạn đã tắt ServiceLB và đặt proxy riêng ở phía trước, proxy đó cũng phải chuyển tiếp challenge path; nếu không, cert-manager sẽ bị kẹt và hiển thị lỗi sau trên Challenge object:
Waiting for HTTP-01 challenge propagation: wrong status code '404', expected '200'Theo dõi quá trình cấp certificate bằng sudo k3s kubectl describe certificate hello-tls và sudo k3s kubectl get order,challenge -A.
kubeconfig và lý do API server vẫn ở chế độ private
k3s ghi thông tin xác thực của admin vào /etc/rancher/k3s/k3s.yaml. File này thuộc sở hữu của root và mặc định được ghi với mode 600. File chứa client certificate có quyền cluster-admin, nên bất kỳ ai đọc được file đều có toàn quyền trên cluster.
sudo k3s kubectl get node
export KUBECONFIG=/etc/rancher/k3s/k3s.yaml
kubectl get nodekubectl được cài riêng không tự biết đến file của k3s. Khi KUBECONFIG chưa được đặt, kubectl đọc ~/.kube/config. Nếu file đó không tồn tại, kubectl báo lỗi The connection to the server localhost:8080 was refused - did you specify the right host or port? vì chưa được cấu hình cluster nào. Hãy đặt KUBECONFIG, sao chép file vào ~/.kube/config như bên dưới, hoặc dùng sudo k3s kubectl để kubectl tự đọc đúng file.
Bạn sẽ thấy --write-kubeconfig-mode 644 thường được khuyến nghị để user thông thường có thể chạy kubectl. Cần hiểu rõ tác động của cách này: credential có quyền cluster-admin sẽ có thể được mọi account cục bộ trên máy đọc. Trên máy chỉ có một admin, đây có thể là đánh đổi chấp nhận được. Trên máy dùng chung, không nên làm vậy. Sao chép file sẽ chỉ cấp quyền cho một user mà không công khai credential:
mkdir -p ~/.kube
sudo install -o $USER -g $USER -m 600 /etc/rancher/k3s/k3s.yaml ~/.kube/configDòng server: trong file đó đọc https://127.0.0.1:6443. Để dùng kubectl từ laptop, không mở cổng 6443 ra internet. Kubernetes API public luôn là mục tiêu bị quét và tấn công; API bị expose có thể khiến cluster nhỏ bị dùng để đào cryptocurrency cho người khác. Hãy tunnel qua SSH và giữ nguyên địa chỉ trong file:
ssh -N -L 6443:127.0.0.1:6443 user@your-vps
KUBECONFIG=./k3s.yaml kubectl get nodeNếu bắt buộc phải truy cập API qua địa chỉ private network, hãy cài đặt bằng tls-san với tên hoặc địa chỉ đó, rồi sửa dòng server: trong file đã sao chép để khớp. Nếu không có entry SAN (subject alternative name), kubectl sẽ từ chối kết nối:
x509: certificate is valid for 127.0.0.1, 10.43.0.1, not 203.0.113.10Các cổng inbound được tài liệu hóa cho một cluster là TCP 6443 cho API, UDP 8472 cho flannel VXLAN giữa các node và TCP 10250 cho kubelet metrics. Trên node đơn, không cổng nào trong số này cần mở ra internet.
containerd không phải Docker
k3s chạy containerd tích hợp riêng và không dùng chung image store với Docker. Image bạn vừa build bằng docker build không hiển thị trong k3s, nên pod fail với ErrImagePull dù docker images vẫn liệt kê image đó. Hãy import image một cách rõ ràng:
docker save myapp:0.1 | sudo k3s ctr images import -
sudo k3s crictl imagesSau đó, không dùng tag :latest cho container này, vì :latest mặc định thành imagePullPolicy của Always và kubelet vẫn truy vấn registry. Mọi tag khác đều mặc định thành IfNotPresent, sử dụng image bạn đã import. Chạy cả hai trên một VPS vẫn được. Bạn cần biết rằng cài Docker thông thường trên VPS và k3s đều duy trì image store riêng và các rule iptables riêng trên cùng một máy.
Cách gỡ k3s
Installer tạo sẵn một script gỡ cài đặt. Không có cơ chế gỡ một phần và cũng không có cách hoàn tác.
sudo /usr/local/bin/k3s-uninstall.shScript này dừng và xóa service, xóa datastore, xóa dữ liệu persistent volume, xóa cấu hình node và xóa các công cụ mà installer đã thêm. Trên agent node, script là k3s-agent-uninstall.sh. Hãy sao chép mọi thứ trong /var/lib/rancher/k3s/storage ra khỏi máy trước, vì thư mục đó cũng sẽ bị xóa. Sau đó, dùng ip link show và sudo ss -lntp để kiểm tra xem còn tiến trình nào giữ các port hoặc interface hay không. Interface cni0 hoặc flannel.1 còn sót lại sẽ tự được xóa ở lần reboot tiếp theo.
Nhận ra rằng một node Kubernetes tạo ra nhiều thành phần hơn mức công việc cần là điều bình thường, không phải thất bại. Thường bạn có thể chuyển các workload đó về Compose trong một buổi chiều.
Các dạng lỗi và chuỗi bạn sẽ thấy
Node ở trạng thái NotReady hoặc k3s khởi động lại liên tục. Trước tiên hãy đọc sudo journalctl -u k3s -n 200 --no-pager. Trên VPS nhỏ, nguyên nhân thường gặp là kernel out-of-memory killer dừng tiến trình. Sự kiện này xuất hiện trong dmesg dưới dạng một dòng có tên k3s-server. Mức tối thiểu được tài liệu ghi là 2 GB và đây là mức tối thiểu thực tế.
Pod bị kẹt ở trạng thái Pending. kubectl describe pod luôn chỉ rõ nguyên nhân. Insufficient memory hoặc Insufficient cpu nghĩa là node không còn đủ tài nguyên. didn't have free ports nghĩa là một Kubernetes pod khác đã reserve một hostPort bị xung đột. waiting for first consumer trên một PVC nghĩa là WaitForFirstConsumer đang hoạt động đúng.
ImagePullBackOff. Node không thể pull image. Hãy kiểm tra tên và tag của image, quyền truy cập và credential của registry, hoặc kiểm tra xem bạn có build image bằng Docker nhưng chưa import image đó vào containerd hay không.
Traefik phản hồi nhưng app không phản hồi. Response body là 404 page not found nghĩa là phản hồi đến từ chính Traefik. Request đã đến nơi nhưng không có router nào match. Hãy kiểm tra Ingress host có khớp với tên bạn đã nhập không, và ingressClassName có phải là traefik không.
DNS của cluster lỗi trong khi host vẫn phân giải được tên. Kiểm tra CoreDNS bằng sudo k3s kubectl -n kube-system logs -l k8s-app=kube-dns. Thông báo như plugin/loop: Loop ... detected for zone "." sẽ khiến CoreDNS không khởi động được. Lỗi này xảy ra vì CoreDNS forward request đến một resolver lại forward ngược về chính nó. Đây là hành vi do địa chỉ loopback trong /etc/resolv.conf gây ra. Hãy trỏ k3s đến file upstream thực bằng --resolv-conf /run/systemd/resolve/resolv.conf.
FAQ
Có nên chạy k3s trên một VPS duy nhất không?
Nên chạy khi bạn muốn dùng Kubernetes API: học Kubernetes trên một máy do bạn kiểm soát, giữ deployment ở dạng manifest để dễ chuyển đổi, chạy phần mềm chỉ phát hành Helm chart, hoặc xây dựng hệ thống mà sau này bạn sẽ chuyển sang cluster managed. Không nên chạy khi bạn chỉ muốn chạy container, vì Docker Compose làm việc đó với ít thành phần phải bảo trì hơn nhiều và thường để trống thêm khoảng 1 GB RAM. Một node không cung cấp high availability, nên độ tin cậy không bao giờ là lý do để chọn mô hình này.
Vì sao service LoadBalancer của k3s vẫn ở trạng thái Pending?
ServiceLB tạo các pod svclb- để chiếm các port của service dưới dạng hostPort trên node. Vì vậy, các pod này chỉ được schedule trên node còn trống những port đó. Nếu một Kubernetes pod khác đã reserve cùng hostPort, pod này sẽ ở trạng thái Pending và service không bao giờ nhận được địa chỉ bên ngoài. Một host proxy hoặc Docker container độc lập đang listen trên port 80 tự nó không gây ra lỗi từ chối scheduling này. kubectl -n kube-system describe pod svclb-... báo cáo 0/1 nodes are available: 1 node(s) didn't have free ports for the requested pod ports. Xóa reservation hostPort xung đột của pod, hoặc tắt ServiceLB bằng --disable=servicelb rồi proxy đến NodePort mà service vẫn được cấp.
k3s cần bao nhiêu RAM trên VPS?
Mức tối thiểu được ghi trong tài liệu cho một server node là 2 core và 2 GB. Mức này bao gồm k3s cùng các component đi kèm trước khi chạy workload của bạn. Việc profiling của dự án đo control plane và datastore của một server node ở mức 1,596 MB khi một monitoring stack đang chạy trên đó. Con số này không bao gồm RAM của workload, vì vậy hãy xem 2 GB là mức tối thiểu và 4 GB là cấu hình đầu tiên đủ thoải mái cho một node. Đo máy của bạn bằng free -h trước khi cài đặt, rồi đo lại sau khi mọi pod trong kube-system có trạng thái Running.
Có thể chạy Docker và k3s trên cùng một VPS không?
Có, và chúng vẫn tách biệt. k3s dùng containerd tích hợp riêng, nên image được build bằng docker build sẽ không hiển thị trong k3s cho đến khi bạn chạy docker save myapp:0.1 | sudo k3s ctr images import -. Mỗi bên cũng tự ghi các rule iptables riêng và tạo các bridge network riêng. Hãy theo dõi tổng mức sử dụng RAM, vì Docker, k3s và các container của bạn cùng chia sẻ RAM của máy.
Làm cách nào để gỡ hoàn toàn k3s?
Chạy sudo /usr/local/bin/k3s-uninstall.sh trên server node hoặc sudo /usr/local/bin/k3s-agent-uninstall.sh trên agent. Lệnh này dừng service, xóa datastore, xóa dữ liệu persistent volume trong /var/lib/rancher/k3s/storage và gỡ các tool đi kèm. Hãy copy dữ liệu cần giữ ra khỏi máy trước, vì không có cách undo. Interface network cni0 hoặc flannel.1 còn sót lại sẽ biến mất sau lần reboot tiếp theo.