اجرای k3s روی یک VPS: چه زمانی ارزشش را دارد؟
نصب k3s روی یک VPS با استفاده از دستور تکخطی امکانپذیر است. در این مطلب بررسی میکنیم که مصرف RAM چقدر است، چرا پورت 80 دچار تداخل میشود و چه زمانی Docker Compose گزینه بهتری است.
k3s چیست و یک نود آن چه امکاناتی به شما میدهد
k3s یک توزیع کامل از Kubernetes است که در قالب یک فایل باینری واحد بستهبندی شده است. اجرای آن روی یک VPS تکی، API واقعی Kubernetes را بدون نیاز به یک control plane سه ماشینی در اختیار شما قرار میدهد. این یک توزیع تأییدشده (certified) از Kubernetes است، بنابراین manifestای که در اینجا اعمال میکنید، بعداً در یک کلاستر مدیریتشده نیز کار خواهد کرد. نصب آن تنها با یک دستور و در حدود یک دقیقه انجام میشود. هزینهای که میپردازید، بخشی از حافظه (RAM) است که دیگر در دسترس برنامههای شما نخواهد بود، بهعلاوه مجموعهای از حالتهای شکست (failure modes) که هرگز در Docker Compose رخ نمیدهند.
شرکت SUSE، نرمافزار k3s را برای سایتهای لبه (edge) و نصبهای کوچک توسعه داده است و تفاوتهای آن با نسخه اصلی Kubernetes صرفاً برای کوچکتر کردن و سادهسازی اجراست. datastore پیشفرض، sqlite است که پشت یک shim به نام kine قرار دارد و etcd نیست؛ بنابراین نیازی به مدیریت quorum برای etcd وجود ندارد. containerd بهجای نصب جداگانه، درون همان فایل باینری تعبیه شده است. همین فایل باینری شامل CoreDNS برای DNS کلاستر، Traefik به عنوان ingress controller، ServiceLB (که klipper-lb نیز نامیده میشود) برای اینکه سرویسهای LoadBalancer بدون نیاز به یک ارائهدهنده ابری کار کنند، local-path provisioner برای persistent volumes، metrics-server و flannel برای شبکه podها است. تمامی این موارد بهصورت پیشفرض اجرا میشوند. این تنظیمات پیشفرض، Traefik را روی پورتهای 80 و 443 قرار میدهند؛ بنابراین پیش از نصب روی VPSای که هماکنون سرویس دیگری را میزبانی میکند، تصمیم بگیرید که کدام سرویس باید از این پورتها استفاده کند.
چه زمانی استفاده از یک نود k3s منطقی است
از این قاعده پیروی کنید: زمانی از k3s استفاده کنید که به API کوبرنتیز نیاز دارید؛ مثلاً در حال یادگیری کوبرنتیز روی دستگاهی هستید که کنترل آن را در دست دارید، یا نرمافزاری که میخواهید نصب کنید فقط به صورت Helm chart منتشر شده است. قابلیت انتقال مانیفستها نیز اهمیت دارد، زیرا Deploymentای که اینجا مینویسید، بدون تغییر به یک کلاستر مدیریتشده منتقل میشود. زمانی از Docker Compose استفاده کنید که هدف اصلی شما خودِ برنامهها هستند. Compose همان کانتینرها را با اجزای متحرک بسیار کمتری اجرا میکند و خواندن یک فایل Compose روی یک VPS پس از یک سال، بسیار آسانتر از بررسی یک دایرکتوری پر از مانیفست است.
دقیق باشید که یک نود چه چیزی به شما نمیدهد:
- عدم وجود High Availability. وقتی VPS ریبوت میشود، تمام workloadها متوقف میشوند. کوبرنتیز تلاش میکند پاد را روی نود دیگری زمانبندی کند، اما نود دیگری وجود ندارد.
- عدم وجود rolling update که سرویس را بالا نگه دارد، مگر اینکه برنامه دو replica را روی یک ماشین تحمل کند و نود نیز فضای کافی برای هر دو داشته باشد.
- ذخیرهسازی که به همان دستگاه محدود است، به دلیلی که در بخش local-path در ادامه توضیح داده شده است.
- یک control plane که فارغ از اینکه چیزی روی آن مستقر کرده باشید یا نه، حدود یک گیگابایت رم اشغال میکند.
هیچکدام از این موارد k3s را به انتخاب بدی تبدیل نمیکند. این موارد فقط به این دلیل آن را به انتخاب بدی تبدیل میکنند که مردم معمولاً به اشتباه به دنبال قابلیت اطمینان (reliability) هستند. اگر هدف واقعی شما داشتن چندین ماشین برای ساخت یک کلاستر چند-نودی واقعی است، آن تصمیم در اولویت قرار دارد: Proxmox روی سختافزار شخصی در برابر VPS اجارهای مشخص میکند که نودها از کجا میآیند، پیش از آنکه k3s تعیین کند چه چیزی روی آنها اجرا شود.
هزینه RAM و CPU برای k3s پیش از استقرار هر سرویس
پروژه k3s به جای تخمین، ارقام اندازهگیریشده را منتشر میکند. آنها را با دقت بخوانید، زیرا عددی که افراد نقل میکنند، مربوط به k3s در حالت idle نیست.
دادههای پشت این نمودار
[
{
"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
}
]یک گره سرور در آن تست، در صدک 95، 1,596 مگابایت RAM و حدود 6 درصد از یک هسته CPU مصرف کرد. اینها ارقام منتشرشده هستند، نه اندازهگیریهای این راهنما. این تست k3s نسخه v1.26.5 را با تمام کامپوننتهای بستهبندیشده فعال، به همراه پشته مانیتورینگ Prometheus و Grafana اجرا کرد؛ بنابراین کلاستر مشغول بود، نه خالی. با این حال، پروژه اعلام میکند که این ارقام فقط شامل دیتاستور Kubernetes و control plane است و نیازهای خاص workloadها را شامل نمیشود. کانتینرهای شما به این مقدار اضافه میشوند. جایگزینی sqlite با etcd تعبیهشده، مصرف را به 1,606 مگابایت رساند. یک گره agent که kubelet و containerd را بدون control plane اجرا میکند، 275 مگابایت مصرف کرد. حداقلِ مستندشده برای یک سرور، 2 هسته و 2 گیگابایت RAM است و این حداقل، k3s و کامپوننتهای بستهبندیشدهاش را پیش از workloadهای شما پوشش میدهد.
برداشت کاربردی: روی یک VPS با 2 گیگابایت RAM، کنترل پلین و افزونههای همراه آن فضای بسیار کمی برای شما باقی میگذارند. تحت فشار حافظه، kubelet پادها را اخراج (evict) میکند، اما اگر مصرف حافظه بهسرعت افزایش یابد، OOM killer هسته سیستمعامل ممکن است پیش از آنکه kubelet فشار را تشخیص دهد، وارد عمل شود. 4 گیگابایت یک کفِ مناسب برای یک گره با چند سرویس کوچک است. بهجای اعتماد به هر رقم منتشرشده، از جمله این مورد، سرور خود را اندازهگیری کنید.
free -h
sudo k3s kubectl top node
sudo k3s kubectl get pods -Aپیش از نصب، دستور free -h را اجرا کنید و دوباره زمانی که وضعیت تمام پادها در kube-system به حالت Running درآمد، آن را تکرار کنید. تفاوت این دو، هزینه control plane روی سختافزار شماست. k3s kubectl top node در یک یا دو دقیقه اول پس از نصب، error: Metrics API not available را برمیگرداند، زیرا metrics-server هنوز چیزی را اسکن نکرده است. این یک خطا نیست. اگر قصد دارید یک سرور را همزمان برای این کار و سایر وظایف آماده کنید، محاسبات مربوط به تخمین RAM و CPU برای یک VPS در اینجا نیز بدون تغییر صدق میکند.
نصب k3s با نسخه ثابت (Pinned) به جای آخرین نسخه
دستور نصب سریعی که همه کپی میکنند، هر نسخهای را که در لحظه اجرا در کانال stable قرار دارد نصب میکند. روی ماشینی که قصد نگهداری آن را دارید، نسخه را ثابت کنید. k3s برای هر نسخه فرعی (minor) از Kubernetes یک کانال منتشر میکند، بنابراین INSTALL_K3S_CHANNEL=v1.36 نسخههای اصلاحی (patch) درون v1.36 را دنبال میکند و هرگز بهطور خودکار به نسخه فرعی بعدی نمیجهد. از اکتبر 2026، کانال stable به نسخه v1.36.5+k3s1 اشاره دارد.
ابتدا فایل پیکربندی را بنویسید و سپس نصب را انجام دهید. k3s فایل /etc/rancher/k3s/config.yaml را هنگام شروع میخواند، بنابراین هر چیزی که در آن باشد، هم در اولین بوت و هم در بوتهای بعدی اعمال میشود.
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 -برای ثابت کردن یک نسخه دقیق به جای استفاده از کانال، از INSTALL_K3S_VERSION=v1.36.5+k3s1 استفاده کنید. علامت مثبت بخشی از تگ است. سپس بررسی کنید که سرویس بالا آمده باشد.
k3s --version
sudo systemctl status k3s
sudo k3s kubectl get node
sudo k3s kubectl get pods -Aدستور kubectl get node باید ظرف حدود 30 ثانیه یک گره (node) با وضعیت Ready را فهرست کند و تمام پادها در kube-system باید به وضعیت Running یا Completed برسند. گیر کردن یک گره در وضعیت NotReady معمولاً به این معنی است که container runtime هرگز شروع نشده است، بنابراین sudo journalctl -u k3s -n 100 --no-pager را بخوانید. در تصاویر VPS غیرمعمول، پیش از هر اقدام عیبیابی، sudo k3s check-config را اجرا کنید: این دستور ویژگیهای مفقود هسته (kernel) را گزارش میدهد که بسیار سریعتر از خواندن لاگها به نتیجه میرسد.
چرا پورت 80 در حال استفاده است و برای رفع آن چه چیزی را باید فدا کرد
این خطایی است که کاربران در VPSهایی که از قبل سرویسی روی آنها اجرا شده، با آن مواجه میشوند. نصب با موفقیت انجام میشود، اما اگر یک pod دیگر در Kubernetes قبلاً همان hostPort را روی تنها نود موجود رزرو کرده باشد، Traefik هرگز آدرسی دریافت نمیکند.
مکانیسم: چارت پیشفرض Traefik یک Service از نوع LoadBalancer روی پورتهای 80 و 443 ایجاد میکند. ServiceLB با ایجاد یک DaemonSet از podهای کوچک که با پیشوند svclb- نامگذاری شدهاند، به این درخواست پاسخ میدهد؛ این podها شماره پورتهای مذکور را به عنوان hostPort روی هر نود مطالبه میکنند. hostPort ترافیک را از پورت نود به pod از طریق قوانین شبکه هدایت میکند. زمانبند (scheduler) پورتهای host اعلامشده توسط podهای Kubernetes را بررسی میکند، نه سوکتهایی که توسط سرویسهای میزبان یا کانتینرهای مستقل Docker اشغال شدهاند. pod دیگری که همان hostPort را رزرو کرده باشد، مانع از زمانبندی میشود؛ اما nginx، Caddy، Apache یا یک کانتینر مستقل Docker که روی پورت 80 گوش میدهد، بهتنهایی باعث رد شدن زمانبندی نمیشود.
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 )'با وجود رزرو تداخلی hostPort توسط یک pod دیگر در Kubernetes، وضعیت pod مربوط به svclb را Pending و سرویس را بدون آدرس خارجی خواهید دید:
svclb-traefik-8f2c1a-r6k9x 0/2 Pending 0 3m
traefik LoadBalancer 10.43.62.11 <pending> 80:31480/TCP,443:30219/TCPاجرای kubectl -n kube-system describe pod svclb-traefik-... علت را مستقیماً بیان میکند:
0/1 nodes are available: 1 node(s) didn't have free ports for the requested pod ports.دستور ss -lntp به شما میگوید کدام پردازش روی پورت گوش میدهد؛ این دستور رزروهای hostPort که توسط زمانبند بررسی میشوند را نشان نمیدهد. بیش از یک راه برای خروج وجود دارد و هر کدام هزینهای برای شما خواهد داشت.
پورتها را به k3s بدهید. هرگونه رزرو تداخلی hostPort از podهای دیگر Kubernetes را حذف کنید و وبسرور میزبان موجود را متوقف و غیرفعال کنید تا Traefik ترافیک ورودی را روی 80 و 443 مدیریت کند. این پاسخ درستی است زمانی که VPS قرار است فقط یک سرور k3s باشد و هر چیزی که قبلاً میزبانی میکردید به پشت یک Ingress منتقل شود.
سرویس ServiceLB را غیرفعال کنید و پروکسی فعلی خود را نگه دارید. با استفاده از --disable=servicelb نصب کنید. یک Service از نوع LoadBalancer همچنان یک NodePort اختصاص میدهد، بنابراین Traefik روی یک پورت بالا مانند 31480 در دسترس باقی میماند و nginx یا Caddy شما به 127.0.0.1:31480 پروکسی میکند. چیزی که از دست میدهید آدرس خارجی است: سرویس برای همیشه <pending> را گزارش میدهد، که اگر انتخابی آگاهانه باشد، به نظر یک خطا میرسد.
Traefik را غیرفعال کنید و با پروکسی خودتان مسیریابی کنید. با استفاده از --disable=traefik نصب کنید. در این حالت شما هیچ ingress controller ندارید، بنابراین اشیاء Ingress هیچ کاری انجام نمیدهند: آنها در API باقی میمانند بدون اینکه کنترلی روی آنها نظارت کند. این کار زمانی که از یک پروکسی میزبان به NodePortها مسیریابی میکنید مناسب است و اگر از قبل میدانید چگونه میخواهید HTTP را مدیریت کنید، انتخاب صادقانهای است. اگر در مورد اینکه چه چیزی باید در لایه اول قرار بگیرد تردید دارید، پیش از غیرفعال کردن هر چیزی، انتخاب بین nginx، Caddy و Traefik به عنوان reverse proxy را نهایی کنید.
هر دو فلگ متعلق به نصبکننده یا فایل پیکربندی هستند:
tls-san:
- k3s.example.com
disable:
- traefik
- servicelbویرایش آن فایل پس از نصب و اجرای sudo systemctl restart k3s نیز کارساز است، زیرا --disable کاری فراتر از نادیده گرفتن یک کامپوننت در زمان نصب انجام میدهد. این دستور کامپوننتی که قبلاً مستقر شده را نیز حذف میکند، بنابراین تغییرات روی کلاستر در حال اجرا اعمال میشود.
برای حفظ Traefik اما تغییر نحوه پیکربندی چارت، /var/lib/rancher/k3s/server/manifests/traefik.yaml را ویرایش نکنید. k3s هر بار که شروع به کار میکند، آن فایل را با مقادیر پیشفرض بازنویسی میکند. در عوض، یک فایل جداگانه در همان دایرکتوری اضافه کنید، زیرا هر چیزی در /var/lib/rancher/k3s/server/manifests بهطور خودکار در زمان راهاندازی و هر زمان که روی دیسک تغییر کند، اعمال میشود.
apiVersion: helm.cattle.io/v1
kind: HelmChartConfig
metadata:
name: traefik
namespace: kube-system
spec:
valuesContent: |-
ports:
web:
forwardedHeaders:
trustedIPs:
- 10.0.0.0/8آن مثال یک مقدار از چارت Traefik، یعنی آدرسهای پروکسی مورد اعتماد (trusted proxy addresses) را تنظیم میکند. همین مکانیسم هر مقدار دیگری که چارت در معرض دید قرار میدهد، از جمله پورتهای آن را تنظیم میکند.
ذخیرهسازی پایدار روی یک گره
نرمافزار k3s بهصورت پیشفرض یک StorageClass به نام local-path ارائه میدهد که توسط local-path provisioner شرکت Rancher پشتیبانی میشود. هر PersistentVolumeClaim که فاقد storageClassName باشد، از این کلاس استفاده میکند. حجمها در مسیر /var/lib/rancher/k3s/storage و در زیرشاخههای مجزا برای هر حجم، روی دیسک همان گره ذخیره میشوند.
sudo k3s kubectl get storageclass
sudo k3s kubectl get pvc -A
sudo ls -l /var/lib/rancher/k3s/storageعبارت «روی دیسک همان گره» دو پیامد دارد که در آینده، و نه امروز، مشکلساز خواهند شد.
این StorageClass از volumeBindingMode: WaitForFirstConsumer استفاده میکند؛ بنابراین یک PVC جدید تا زمانی که یک pod واقعاً آن را mount نکند، در وضعیت Pending باقی میماند. دستور kubectl describe pvc این وضعیت را نمایش میدهد:
waiting for first consumer to be created before bindingاین رفتار عادی است، بنابراین ایجاد یک PVC بهتنهایی و انتظار برای تغییر وضعیت آن، هرگز مشکل را حل نخواهد کرد.
پس از اتصال (bound)، حجم مذکور دارای یک node affinity برای گرهای است که آن را ایجاد کرده است. این ویژگی باعث میشود هر pod که از آن claim استفاده میکند، تا پایان عمر آن حجم به همان گره محدود شود. در یک تکگره، شما هرگز متوجه این موضوع نخواهید شد. اما اگر بعداً گره دومی اضافه کنید، podای که از جابهجایی امتناع میکند ممکن است شبیه به یک باگ در scheduler به نظر برسد، تا زمانی که دستور kubectl get pv -o yaml را اجرا کنید و نام میزبان را در بخش nodeAffinity مشاهده کنید.
تهیه نسخه پشتیبان بر عهده شماست. بازسازی VPS باعث نابودی آن دایرکتوری میشود و اسکریپت حذف (uninstall) زیر نیز همین کار را انجام میدهد. از مسیر /var/lib/rancher/k3s/storage، بهعلاوه دایرکتوری دیتابیس sqlite یعنی /var/lib/rancher/k3s/server/db/ (که باید در زمان متوقف بودن سرویس کپی شود، زیرا یک دیتابیس زنده است) و همچنین فایل توکن سرور در /var/lib/rancher/k3s/server/token نسخه پشتیبان تهیه کنید. توکن اختیاری نیست: مستندات k3s تأکید دارند که هنگام بازیابی دیتابیس از نسخه پشتیبان، باید آن فایل را بازیابی کنید یا مقدار آن را به --token بدهید. راه جایگزین این است که کلاستر را یک موجودیت یکبارمصرف در نظر بگیرید و تمام manifestها را در git نگهداری کنید.
Ingress و TLS
با فعال بودن Traefik، تنها چیزی که نیاز دارید یک شیء Ingress استاندارد است.
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: 80گواهیها بهصورت خودکار ظاهر نمیشوند. راهحل معمول، استفاده از cert-manager است که از طریق manifest منتشرشده نصب میشود و به یک ClusterIssuer نیاز دارد. نسخه v1.21.3 که در تاریخ 23 اکتبر 2026 منتشر شده، نسخه جاری تا اکتبر 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: traefikچالش HTTP-01 به این معناست که سرور ACME (محیط مدیریت خودکار گواهی) از طریق اینترنت عمومی به http://hello.example.com/.well-known/acme-challenge/... متصل میشود. بنابراین، رکورد DNS دامنه (یک رکورد A یا اگر VPS از طریق IPv6 در دسترس است، یک رکورد AAAA) باید از قبل به VPS اشاره کند و پورت 80 باید به Traefik برسد. Let’s Encrypt در صورت وجود هر دو آدرس، ابتدا IPv6 را امتحان میکند، اما اگر اتصال اولیه IPv6 با وقفه (timeout) مواجه شود، به IPv4 بازمیگردد. سایر خطاها، از جمله پاسخ اشتباه به چالش، باعث این بازگشت نمیشوند و درخواستهای redirectشده نیز دوباره امتحان نمیشوند. رکورد AAAA قدیمی را اصلاح یا حذف کنید. اگر ServiceLB را غیرفعال کردهاید و یک پروکسی اختصاصی در مقابل قرار دادهاید، آن پروکسی باید مسیر چالش را نیز فوروارد کند، در غیر این صورت cert-manager روی شیء Challenge با این وضعیت متوقف میماند:
Waiting for HTTP-01 challenge propagation: wrong status code '404', expected '200'صدور گواهی را با sudo k3s kubectl describe certificate hello-tls و sudo k3s kubectl get order,challenge -A مانیتور کنید.
فایل kubeconfig و دلیل خصوصی ماندن API server
k3s اعتبارنامههای مدیریتی را در /etc/rancher/k3s/k3s.yaml مینویسد. مالک این فایل root است و بهطور پیشفرض با دسترسی 600 ایجاد میشود. این فایل حاوی یک گواهی کلاینت با سطح دسترسی cluster-admin است، بنابراین هر کسی که بتواند آن را بخواند، کنترل کامل کلاستر را در اختیار میگیرد.
sudo k3s kubectl get node
export KUBECONFIG=/etc/rancher/k3s/k3s.yaml
kubectl get nodeابزار kubectl که بهصورت جداگانه نصب شده باشد، از وجود فایل k3s بیاطلاع است. اگر متغیر KUBECONFIG تنظیم نشده باشد، این ابزار به سراغ ~/.kube/config میرود و اگر آن فایل وجود نداشته باشد، با خطای The connection to the server localhost:8080 was refused - did you specify the right host or port? مواجه میشود، زیرا هیچ کلاستری برای آن پیکربندی نشده است. متغیر KUBECONFIG را تنظیم کنید، فایل را طبق دستور زیر به ~/.kube/config کپی کنید، یا از sudo k3s kubectl استفاده کنید که بهطور خودکار فایل صحیح را میخواند.
ممکن است توصیه به استفاده از --write-kubeconfig-mode 644 را ببینید تا یک کاربر معمولی بتواند kubectl را اجرا کند. بدانید که این کار چه معنایی دارد: این دستور باعث میشود اعتبارنامه cluster-admin برای تمام اکانتهای محلی روی سیستم قابل خواندن باشد. در سیستمی که فقط یک مدیر دارد، این کار ممکن است قابلقبول باشد، اما در سیستمهای اشتراکی چنین نیست. کپی کردن فایل به جای آن، دسترسی را تنها به یک کاربر میدهد بدون اینکه آن را عمومی کند:
mkdir -p ~/.kube
sudo install -o $USER -g $USER -m 600 /etc/rancher/k3s/k3s.yaml ~/.kube/configخط server: در آن فایل به صورت https://127.0.0.1:6443 است. برای استفاده از kubectl از روی لپتاپ خود، پورت 6443 را روی اینترنت باز نکنید. یک Kubernetes API عمومی یک هدف همیشگی برای حملات است و باز گذاشتن آن دلیلی است که کلاسترهای کوچک در نهایت برای دیگران استخراج ارز دیجیتال انجام میدهند. آن را از طریق SSH تونل کنید و آدرس موجود در فایل را تغییر ندهید:
ssh -N -L 6443:127.0.0.1:6443 user@your-vps
KUBECONFIG=./k3s.yaml kubectl get nodeاگر مجبور هستید از طریق یک آدرس شبکه خصوصی به API دسترسی پیدا کنید، نصب را با tls-san و ذکر آن نام یا آدرس انجام دهید، سپس خط server: در فایل کپیشده را مطابق با آن ویرایش کنید. بدون وجود ورودی SAN (مخفف subject alternative name)، ابزار kubectl اتصال را رد میکند:
x509: certificate is valid for 127.0.0.1, 10.43.0.1, not 203.0.113.10پورتهای ورودی مستندشده برای یک کلاستر عبارتند از TCP 6443 برای API، UDP 8472 برای flannel VXLAN بین نودها، و TCP 10250 برای متریکهای kubelet. در یک تکنود، هیچکدام از این پورتها نیازی به باز بودن روی اینترنت ندارند.
نرمافزار containerd همان Docker نیست
نرمافزار k3s از containerd تعبیهشدهٔ اختصاصی خود استفاده میکند و مخزن ایمیج (image store) آن با Docker مشترک نیست. ایمیجی که بهتازگی با docker build ساختهاید برای k3s قابل مشاهده نیست، بنابراین pod با خطای ErrImagePull مواجه میشود، حتی اگر docker images آن را فهرست کند. آن را بهصورت صریح import کنید:
docker save myapp:0.1 | sudo k3s ctr images import -
sudo k3s crictl imagesسپس از تگ :latest برای آن کانتینر پرهیز کنید، زیرا :latest بهصورت پیشفرض از imagePullPolicy مقدار Always استفاده میکند و kubelet در هر صورت به سراغ یک registry میرود. هر تگ دیگری بهصورت پیشفرض از IfNotPresent استفاده میکند که همان ایمیجی است که import کردهاید. اجرای همزمان هر دو روی یک VPS امکانپذیر است و دانستن این نکته کمک میکند که نصب معمولی Docker روی یک VPS و k3s هر کدام مخزن ایمیج و قوانین iptables اختصاصی خود را روی همان ماشین حفظ میکنند.
نحوه حذف k3s
نصبکننده یک اسکریپت حذف (uninstall) ایجاد میکند. امکان حذف جزئی یا بازگرداندن تغییرات (undo) وجود ندارد.
sudo /usr/local/bin/k3s-uninstall.shاین اسکریپت سرویس را متوقف و حذف میکند، datastore را پاک میکند، دادههای persistent volume را از بین میبرد، پیکربندی node را حذف کرده و ابزارهایی که نصبکننده اضافه کرده است را پاکسازی میکند. در یک agent node، اسکریپت به جای آن k3s-agent-uninstall.sh است. پیش از هر چیز، هر فایلی که در /var/lib/rancher/k3s/storage قرار دارد را از سرور کپی و خارج کنید، زیرا این دایرکتوری همراه با حذف سرویس پاک میشود. پس از آن، با استفاده از ip link show و sudo ss -lntp بررسی کنید که هیچ پردازشی پورتها یا اینترفیسها را اشغال نکرده باشد. اینترفیسهای باقیمانده cni0 یا flannel.1 در reboot بعدی پاک میشوند.
اینکه به این نتیجه برسید که یک node از Kubernetes برای نیاز پروژه شما بیش از حد پیچیده است، یک نتیجهگیری منطقی است و نه یک شکست. انتقال آن workloadها به Compose معمولاً در یک بعدازظهر انجام میشود.
حالتهای شکست و رشتههایی که مشاهده خواهید کرد
وضعیت Node NotReady یا راهاندازی مجدد مداوم k3s. ابتدا sudo journalctl -u k3s -n 200 --no-pager را مطالعه کنید. در یک VPS کوچک، دلیل رایج، دخالت kernel out-of-memory killer برای متوقف کردن پردازش است که در dmesg به صورت خطی با نام k3s-server ظاهر میشود. حداقل 2 GB رم که در مستندات ذکر شده، یک حد واقعی است.
وضعیت Pod stuck in Pending. در این حالت kubectl describe pod همیشه دلیل آن را ذکر میکند. Insufficient memory یا Insufficient cpu به این معنی است که گره (node) فضای کافی ندارد. didn't have free ports یعنی یک pod دیگر در Kubernetes، یک hostPort متناقض را رزرو کرده است. waiting for first consumer روی یک PVC به این معنی است که WaitForFirstConsumer به درستی وظیفه خود را انجام میدهد.
خطای ImagePullBackOff. گره نتوانسته است image را دریافت کند. نام و تگ image، دسترسی به registry و اعتبارنامهها را بررسی کنید، یا چک کنید که آیا image را با Docker ساختهاید اما آن را به containerd وارد نکردهاید.
Traefik پاسخ میدهد اما برنامه خیر. بدنه پاسخ 404 page not found مستقیماً از طرف Traefik ارسال میشود و به این معنی است که درخواست رسیده اما هیچ router با آن مطابقت نداشته است. بررسی کنید که Ingress host با نامی که وارد کردهاید مطابقت داشته باشد و ingressClassName برابر با traefik باشد.
سرویس DNS کلاستر با وجود عملکرد صحیح DNS میزبان، شکست میخورد. CoreDNS را با sudo k3s kubectl -n kube-system logs -l k8s-app=kube-dns بررسی کنید. پیامی مانند plugin/loop: Loop ... detected for zone "." مانع از شروع به کار CoreDNS میشود. این اتفاق زمانی رخ میدهد که CoreDNS درخواستها را به resolverای میفرستد که دوباره آنها را به خود CoreDNS بازمیگرداند؛ این همان کاری است که آدرس loopback در /etc/resolv.conf انجام میدهد. k3s را با استفاده از --resolv-conf /run/systemd/resolve/resolv.conf به فایل upstream واقعی هدایت کنید.
FAQ
آیا اجرای k3s روی یک VPS تکی ارزشش را دارد؟
زمانی ارزش دارد که به API کوبرنتیز نیاز داشته باشید: برای یادگیری آن روی ماشینی که کنترلش در دست شماست، حفظ قابلیت جابهجایی دپلویمنتها به صورت مانیفست، اجرای نرمافزاری که فقط Helm chart ارائه میدهد، یا ساخت چیزی که بعداً به یک کلاستر مدیریتشده منتقل خواهید کرد. اگر فقط میخواهید کانتینرها اجرا شوند، ارزشش را ندارد؛ زیرا Docker Compose این کار را با نگهداری بسیار کمتر و حدود یک گیگابایت رم آزاد بیشتر انجام میدهد. یک نود به شما قابلیت دسترسی بالا (High Availability) نمیدهد، بنابراین پایداری هرگز دلیل انتخاب آن نیست.
چرا سرویس LoadBalancer در k3s در وضعیت Pending باقی میماند؟
سرویس ServiceLB پادهای svclb- را ایجاد میکند که پورتهای سرویس را به عنوان hostPort روی نود اشغال میکنند، بنابراین آنها فقط در جایی زمانبندی (schedule) میشوند که آن پورتها آزاد باشند. اگر یک پاد دیگر کوبرنتیز قبلاً همان hostPort را رزرو کرده باشد، پاد در وضعیت Pending میماند و سرویس هرگز آدرس خارجی دریافت نمیکند. یک پروکسی میزبان یا کانتینر Docker مستقل که روی پورت 80 گوش میدهد، بهتنهایی باعث این ردِ زمانبندی نمیشود. kubectl -n kube-system describe pod svclb-... وضعیت 0/1 nodes are available: 1 node(s) didn't have free ports for the requested pod ports را گزارش میدهد. رزرو hostPort پاد متناقض را حذف کنید، یا ServiceLB را با --disable=servicelb غیرفعال کرده و به NodePort که سرویس همچنان تخصیص میدهد، پروکسی کنید.
k3s روی یک VPS به چه مقدار رم نیاز دارد؟
حداقل مقدار مستند برای یک نود سرور، 2 هسته و 2 گیگابایت رم است که k3s و اجزای بستهبندیشدهاش را پیش از بارهای کاری شما پوشش میدهد. پروفایلسازی خود پروژه، کنترل پلین و دیتاستور یک نود سرور را در حالی که یک استک مانیتورینگ روی آن اجرا میشد، 1,596 مگابایت اندازهگیری کرد. این رقم شامل حافظه خودِ بارهای کاری نیست، بنابراین 2 گیگابایت را به عنوان کف و 4 گیگابایت را به عنوان اولین اندازهای در نظر بگیرید که یک نود در آن راحت است. سرور خود را با free -h پیش از نصب و دوباره پس از آنکه تمام پادها در kube-system وضعیت Running را نشان دادند، اندازهگیری کنید.
آیا میتوانم Docker و k3s را روی یک VPS اجرا کنم؟
بله، آنها جدا از هم باقی میمانند. k3s از containerd تعبیهشدهٔ خودش استفاده میکند، بنابراین ایمیجی که با docker build ساخته شده تا زمانی که docker save myapp:0.1 | sudo k3s ctr images import - را اجرا نکنید، برای آن قابل مشاهده نیست. هر کدام قوانین iptables و شبکههای bridge اختصاصی خود را مینویسند. مجموع حافظه را زیر نظر داشته باشید، زیرا Docker، k3s و کانتینرهای شما همگی از رم سرور استفاده میکنند.
چگونه k3s را بهطور کامل حذف کنم؟
sudo /usr/local/bin/k3s-uninstall.sh را روی یک نود سرور یا sudo /usr/local/bin/k3s-agent-uninstall.sh را روی یک ایجنت اجرا کنید. این دستور سرویس را متوقف، دیتاستور را پاک، دادههای persistent volume را در مسیر /var/lib/rancher/k3s/storage حذف و ابزارهای همراه را پاک میکند. پیش از هر کاری، دادههایی را که میخواهید حفظ کنید از سرور خارج کنید، زیرا این عملیات غیرقابل بازگشت است. رابط شبکه باقیمانده cni0 یا flannel.1 در ریبوت بعدی ناپدید میشود.