هل يستحق k3s على VPS واحد؟
يشغّل k3s واجهة Kubernetes API كاملة على VPS واحد، لكنه يستهلك ذاكرة ويصطدم بالمنفذ 80 عند التثبيت. اكتشف متى يبقى Docker Compose خيارك الأفضل.
ماهية k3s وما يوفره لك عقدة واحدة منه
يُعد k3s توزيعة Kubernetes كاملة مجمّعة في ملف ثنائي واحد، وتشغيله على خادم VPS واحد يمنحك واجهة برمجة تطبيقات Kubernetes الحقيقية دون الحاجة إلى مستوى تحكم (control plane) مكوّن من ثلاثة أجهزة. إنه توزيعة Kubernetes معتمدة، لذا فإن أي ملف إعداد (manifest) تطبقه هنا سيعمل على أي عنقود (cluster) مُدار لاحقاً. التثبيت يتم عبر أمر واحد ويستغرق حوالي دقيقة. ما تدفعه مقابل ذلك هو جزء من الذاكرة التي لن تعود متاحة لتطبيقاتك، بالإضافة إلى مجموعة من أنماط الفشل التي لا تحدث أبداً مع Docker Compose.
تبني شركة SUSE نظام k3s للمواقع الطرفية والتثبيتات الصغيرة، واختلافاته عن نسخة Kubernetes الأصلية موجودة لجعله أصغر وأسهل في التشغيل. مخزن البيانات الافتراضي هو sqlite خلف طبقة وسيطة تسمى kine، وليس etcd، لذا لا يوجد نصاب قانوني (quorum) لـ etcd يجب الحفاظ عليه. تم دمج containerd داخل الملف الثنائي بدلاً من تثبيته بشكل منفصل. كما يشحن الملف الثنائي نفسه CoreDNS لخدمة DNS الخاصة بالعنقود، وTraefik كـ ingress controller، وServiceLB (المعروف أيضاً باسم klipper-lb) لتعمل خدمات LoadBalancer دون الحاجة إلى مزود سحابي خلفها، بالإضافة إلى local-path provisioner للأحجام المستمرة (persistent volumes)، وmetrics-server، وflannel لشبكات الـ pods. يبدأ كل واحد من هؤلاء افتراضياً. تضع هذه الإعدادات الافتراضية Traefik على المنفذين 80 و443، لذا حدد من سيستخدم هذه المنافذ قبل التثبيت على خادم VPS كان يقدم خدمات أخرى بالفعل.
متى يكون استخدام عقدة k3s واحدة مجدياً
اتبع هذه القاعدة. شغّل k3s عندما يكون واجهة برمجة تطبيقات Kubernetes هو ما تريده: أنت تتعلم Kubernetes على جهاز تتحكم به، أو أن البرنامج الذي تريده لا يتوفر إلا عبر Helm chart. قابلية نقل ملفات التعريف (Manifests) مهمة أيضاً، لأن كائن Deployment الذي تكتبه هنا ينتقل إلى عنقود (cluster) مُدار دون تغيير. شغّل Docker Compose عندما تكون التطبيقات هي ما تريده. يبدأ Compose نفس الحاويات بعدد أقل بكثير من المكونات المتحركة، ويكون ملف Compose على خادم VPS أسهل في القراءة بعد عام من دليل مليء بملفات التعريف.
كن واضحاً بشأن ما لا توفره لك العقدة الواحدة.
- لا توجد إتاحة عالية (High Availability). عند إعادة تشغيل الـVPS، تتوقف كل أحمال العمل. يعيد Kubernetes جدولة الـpod على عقدة أخرى، ولا توجد عقدة أخرى.
- لا يوجد تحديث تدريجي (Rolling update) يحافظ على عمل الخدمة، إلا إذا كان التطبيق يتحمل وجود نسختين (replicas) على جهاز واحد وكانت العقدة تتسع لكلتيهما.
- التخزين مرتبط بالجهاز نفسه، للسبب الموضح في قسم المسار المحلي (local-path) أدناه.
- مستوى تحكم (Control plane) يستهلك حوالي غيغابايت من ذاكرة الوصول العشوائي سواء قمت بنشر أي شيء أم لا.
لا شيء من ذلك يجعل k3s خياراً سيئاً. إنه يجعله خياراً سيئاً للسبب الذي يذكره الناس عادةً، وهو الموثوقية. إذا كنت تريد بالفعل عدة أجهزة لتبني عنقوداً حقيقياً متعدد العقد، فإن هذا القرار يأتي أولاً: Proxmox على أجهزتك الخاصة مقابل خادم VPS مستأجر يحدد مصدر العقد قبل أن يحدد k3s ما يعمل عليها.
تكلفة k3s من ذاكرة الوصول العشوائي (RAM) والمعالج (CPU) قبل نشر أي شيء
ينشر مشروع k3s أرقاماً مقاسة بدلاً من التقديرات. اقرأها بعناية، لأن الرقم الذي يتداوله الناس لا يمثل حالة الخمول (idle) لـ k3s.
البيانات وراء هذا الرسم البياني
[
{
"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
}
]استخدمت عقدة الخادم (server node) في ذلك الاختبار 1,596 ميجابايت من ذاكرة الوصول العشوائي عند النسبة المئوية 95، وحوالي 6 بالمئة من نواة واحدة. هذه أرقام منشورة، وليست قياسات من هذا الدليل. أجرى الاختبار k3s إصدار v1.26.5 مع تفعيل جميع المكونات المجمعة بالإضافة إلى حزمة مراقبة Prometheus وGrafana، لذا كان العنقود (cluster) مشغولاً وليس فارغاً، لكن المشروع يذكر أن الأرقام تغطي مخزن بيانات Kubernetes ومستوى التحكم (control plane) فقط، وتستثني متطلبات أحمال العمل الخاصة بك. حاوياتك الخاصة تُضاف فوق ذلك. أدى استبدال sqlite بـ etcd المضمن إلى رفع الاستهلاك إلى 1,606 ميجابايت. أما عقدة الوكيل (agent node)، التي تشغل kubelet وcontainerd بدون مستوى تحكم، فقد استخدمت 275 ميجابايت. الحد الأدنى الموثق للخادم هو نواتان و2 جيجابايت من ذاكرة الوصول العشوائي، وهذا الحد الأدنى يغطي k3s ومكوناته المجمعة قبل أحمال عملك.
القراءة العملية هي: على خادم افتراضي (VPS) بسعة 2 جيجابايت، يترك لك مستوى التحكم وإضافاته المجمعة مساحة صغيرة جداً. تحت ضغط الذاكرة، يقوم kubelet بطرد الـ pods، ولكن إذا ارتفع استهلاك الذاكرة بسرعة، فقد يعمل نظام OOM killer الخاص بالنواة قبل أن يكتشف kubelet الضغط. سعة 4 جيجابايت هي حد أدنى مريح لعقدة واحدة مع بضع خدمات صغيرة. قِس استهلاك جهازك الخاص بدلاً من الوثوق بأي رقم منشور، بما في ذلك هذا الرقم.
free -h
sudo k3s kubectl top node
sudo k3s kubectl get pods -Aنفّذ free -h قبل التثبيت ومرة أخرى بمجرد أن تصبح حالة كل pod في kube-system هي Running. الفرق هو ما يكلفه مستوى التحكم على عتادك. يُرجع k3s kubectl top node القيمة error: Metrics API not available لأول دقيقة أو دقيقتين بعد التثبيت، لأن metrics-server لم يجمع أي بيانات بعد. هذا ليس خطأ. إذا كنت تحدد حجم جهاز واحد لهذا الغرض ولأعمال أخرى في نفس الوقت، فإن الحسابات في تحديد حجم RAM وCPU لخادم VPS تنطبق هنا دون تغيير.
ثبّت k3s على إصدار محدد، وليس على الإصدار الأحدث
يستخدم سطر البدء السريع الذي ينسخه الجميع الإصدار الذي تشير إليه القناة المستقرة في يوم تشغيله. إذا كنت تنوي الاحتفاظ بالجهاز، فثبّت الإصدار. ينشر k3s قناة لكل إصدار ثانوي من Kubernetes، لذلك يتبع INSTALL_K3S_CHANNEL=v1.36 إصدارات التصحيح ضمن v1.36 ولا ينتقل تلقائياً إلى إصدار ثانوي آخر. اعتباراً من October 2026، تشير القناة المستقرة إلى 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 عقدة واحدة بحالة Ready خلال نحو ثلاثين ثانية، ويجب أن تصل كل حاوية pod في kube-system إلى الحالة Running أو Completed. تعني العقدة العالقة في NotReady عادةً أن وقت تشغيل الحاويات لم يبدأ، لذلك اقرأ sudo journalctl -u k3s -n 100 --no-pager. في صورة VPS غير اعتيادية، شغّل sudo k3s check-config قبل تصحيح أي مشكلة أخرى؛ فهو يعرض ميزات النواة المفقودة، ويعطيك إجابة أسرع بكثير من قراءة السجلات.
لماذا يكون المنفذ 80 قيد الاستخدام، وما الذي يجب التخلي عنه لإصلاحه
هذا هو الفشل الذي يواجه المستخدمين على خادم افتراضي خاص (VPS) كان يقدم خدمة ما بالفعل. ينجح التثبيت، لكن Traefik لا يحصل أبداً على عنوان إذا كان pod آخر في Kubernetes يحجز مسبقاً نفس الـ hostPort على العقدة الوحيدة.
آلية العمل: ينشئ مخطط Traefik المرفق خدمة (Service) من نوع LoadBalancer على المنفذين 80 و443. يستجيب ServiceLB لهذا الطلب بإنشاء DaemonSet من pods صغيرة، مسمّاة ببادئة svclb-، والتي تطالب بأرقام المنافذ تلك كـ hostPort على كل عقدة. يقوم hostPort بتوجيه حركة المرور من منفذ العقدة إلى الـ pod عبر قواعد الشبكة. يتحقق المجدول (scheduler) من منافذ المضيف التي تعلن عنها pods في Kubernetes، وليس من المقابس (sockets) التي تشغلها خدمات المضيف أو حاويات 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 واحتفظ بالـ proxy الحالي. ثبّت باستخدام --disable=servicelb. لا تزال الخدمة من نوع LoadBalancer تخصص NodePort، لذا يظل Traefik قابلاً للوصول على منفذ مرتفع مثل 31480، ويقوم nginx أو Caddy الخاص بك بالتوجيه إلى 127.0.0.1:31480. ما تتخلى عنه هو العنوان الخارجي: تبلغ الخدمة عن <pending> بشكل دائم، وهو ما يبدو كخطأ بينما هو خيار اتخذته أنت.
عطّل Traefik ووجّه حركة المرور عبر الـ proxy الخاص بك. ثبّت باستخدام --disable=traefik. عندها لن يكون لديك متحكم Ingress، لذا لن تقوم كائنات Ingress بأي شيء: ستبقى في واجهة برمجة التطبيقات (API) دون وجود متحكم يراقبها. هذا مقبول عندما تقوم بالتوجيه من proxy مضيف إلى NodePorts، وهو الخيار الصريح إذا كنت تعرف بالفعل كيف تريد معالجة HTTP. إذا كنت متردداً بشأن ما يجب وضعه في المقدمة، فاحسم الاختيار بين nginx وCaddy وTraefik كـ reverse proxy قبل تعطيل أي شيء.
كلا العلمين (flags) يوضعان عند التثبيت، أو في ملف الإعداد:
tls-san:
- k3s.example.com
disable:
- traefik
- servicelbتعديل ذلك الملف بعد التثبيت وتشغيل sudo systemctl restart k3s يعمل أيضاً، لأن --disable لا يكتفي بتخطي مكون ما أثناء التثبيت فحسب. بل يقوم أيضاً بحذف مكون تم نشره بالفعل، لذا يسري التغيير على العنقود (cluster) قيد التشغيل.
للاحتفاظ بـ Traefik ولكن تغيير كيفية إعداد المخطط (chart)، لا تعدّل /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، وهي عناوين الـ proxy الموثوقة. الآلية نفسها تضبط أي قيمة أخرى يكشف عنها المخطط، بما في ذلك منافذه.
التخزين الدائم على عقدة واحدة
يأتي 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 جديداً في حالة Pending إلى أن يقوم pod بتركيبه فعلياً. يعرض kubectl describe pvc ما يلي:
waiting for first consumer to be created before bindingهذا سلوك طبيعي. لذلك لن يؤدي إنشاء PVC وحده والانتظار إلى تغيير حالته.
بعد الربط، تحمل وحدة التخزين node affinity للعقدة التي أنشأتها. وهذا يقيّد كل pod يستخدم هذا claim بهذه العقدة طوال مدة بقاء وحدة التخزين. على عقدة واحدة لن تلاحظ المشكلة. لكن عند إضافة عقدة ثانية لاحقاً، قد يبدو pod الذي يرفض الانتقال وكأنّه خطأ في المجدول، إلى أن تشغّل kubectl get pv -o yaml وتجد اسم المضيف في nodeAffinity.
أنت مسؤول عن النسخ الاحتياطية. تؤدي إعادة إنشاء VPS إلى حذف ذلك الدليل، وكذلك يفعل برنامج إلغاء التثبيت أدناه. انسخ /var/lib/rancher/k3s/storage احتياطياً، إضافة إلى دليل مخزن sqlite /var/lib/rancher/k3s/server/db/ بعد نسخه والخدمة متوقفة، لأنه قاعدة بيانات قيد الاستخدام، وإضافة إلى ملف رمز الخادم الموجود في /var/lib/rancher/k3s/server/token. الرمز ليس اختيارياً: توضح وثائق k3s أنّه يجب عليك استعادة هذا الملف، أو تمرير قيمته إلى --token، عند استعادة مخزن البيانات من نسخة احتياطية. والبديل هو اعتبار العنقود مؤقتاً والاحتفاظ بكل manifest في git.
الدخول و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 أو سجل AAAA إذا كان الـ VPS قابلاً للوصول عبر IPv6، إلى الـ VPS بالفعل، ويجب أن يصل المنفذ 80 إلى Traefik. يحاول Let’s Encrypt استخدام عنوان IPv6 أولاً عند وجود كلا العنوانين، لكنه يعود إلى IPv4 إذا انتهت مهلة اتصال IPv6 الأولي. الأخطاء الأخرى، بما في ذلك استجابة التحدي الخاطئة، لا تؤدي إلى هذا التراجع، والطلبات المعاد توجيهها لا تحصل على إعادة محاولة. قم بإصلاح أو إزالة سجل AAAA القديم. إذا قمت بتعطيل ServiceLB ووضعت وكيلك الخاص (proxy) في المقدمة، فيجب على ذلك الوكيل إعادة توجيه مسار التحدي أيضاً، وإلا سيتوقف 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 خاصاً
يكتب 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 مضمّنة خاصة به، ولا يشارك مخزن الصور مع Docker. تكون الصورة التي أنشأتها للتو باستخدام docker build غير مرئية لـk3s، لذلك تفشل الـpod مع ErrImagePull رغم أن docker images يعرضها. استوردها صراحةً:
docker save myapp:0.1 | sudo k3s ctr images import -
sudo k3s crictl imagesبعد ذلك، تجنّب استخدام الوسم :latest مع تلك الحاوية، لأن :latest يستخدم افتراضياً imagePullPolicy بقيمة Always، ولذلك يتصل kubelet بسجل الصور على أي حال. تستخدم أي وسم آخر افتراضياً IfNotPresent، الذي يعتمد على الصورة التي استوردتها. يمكن تشغيل كليهما على VPS واحد، ومن المفيد معرفة أن تثبيت Docker عادي على VPS وk3s يحتفظ كل منهما بمخزن الصور الخاص به وقواعد iptables الخاصة به على الجهاز نفسه.
كيفية إزالة k3s
ينشئ برنامج التثبيت نصاً لإلغاء التثبيت. لا توجد إزالة جزئية ولا طريقة للتراجع.
sudo /usr/local/bin/k3s-uninstall.shيوقف الخدمة ويزيلها، ويحذف مخزن البيانات، ويحذف بيانات وحدات التخزين المستمرة، ويزيل إعدادات العقدة، ويزيل الأدوات التي أضافها برنامج التثبيت. في عقدة الوكيل، يكون النص البرمجي هو k3s-agent-uninstall.sh بدلاً من ذلك. انسخ كل ما يوجد ضمن /var/lib/rancher/k3s/storage إلى خارج الخادم أولاً، لأن ذلك المجلد سيُحذف معه. بعد ذلك، تحقق من عدم بقاء أي عملية تستخدم المنافذ أو الواجهات، باستخدام ip link show وsudo ss -lntp. تُزال أي واجهة cni0 أو flannel.1 متبقية عند إعادة التشغيل التالية.
إن تبين أن عقدة واحدة من Kubernetes تتضمن مكونات أكثر مما تتطلبه المهمة، فهذه نتيجة طبيعية وليست فشلاً. وعادةً ما تستغرق إعادة أعباء العمل إلى Compose فترة بعد الظهر.
أنماط الفشل والرسائل التي ستراها
حالة Node NotReady، أو إعادة تشغيل k3s في حلقة مفرغة. اقرأ sudo journalctl -u k3s -n 200 --no-pager أولاً. على خادم VPS صغير، السبب الشائع هو قيام نظام التشغيل بإنهاء العملية بسبب نفاد الذاكرة (OOM killer)، وهو ما يظهر في dmesg كسطر يذكر k3s-server. الحد الأدنى الموثق وهو 2 GB هو حد فعلي لا يمكن تجاوزه.
حالة Pod عالقة في Pending. يذكر kubectl describe pod السبب في كل مرة. يعني Insufficient memory أو Insufficient cpu أن العقدة (node) لم تعد تملك مساحة كافية. يعني didn't have free ports أن Pod أخرى في Kubernetes تحجز منفذ hostPort متعارض. ظهور waiting for first consumer على PVC يعني أن خاصية WaitForFirstConsumer تعمل كما هو متوقع.
خطأ ImagePullBackOff. لم تتمكن العقدة من سحب الصورة. تحقق من اسم الصورة والوسم (tag)، وصلاحيات الوصول إلى السجل (registry)، أو ما إذا كنت قد بنيت الصورة باستخدام Docker ولم تقم باستيرادها إلى containerd.
Traefik يستجيب، والتطبيق لا يستجيب. رد يأتي بنص 404 page not found يصدر عن Traefik نفسه، ويعني أن الطلب وصل ولكن لم يطابق أي مسار (router). تحقق من أن اسم Ingress في host يطابق الاسم الذي أدخلته، وأن ingressClassName مضبوط على traefik.
فشل DNS الخاص بالعنقود بينما يحل المضيف الأسماء بشكل صحيح. افحص CoreDNS باستخدام sudo k3s kubectl -n kube-system logs -l k8s-app=kube-dns. رسالة مثل plugin/loop: Loop ... detected for zone "." تمنع CoreDNS من البدء. يحدث هذا لأن CoreDNS يعيد توجيه الطلبات إلى مُحلل (resolver) يعيد توجيهها إليه مجدداً، وهو ما يفعله عنوان loopback في /etc/resolv.conf. وجّه k3s إلى ملف المنبع (upstream) الحقيقي باستخدام --resolv-conf /run/systemd/resolve/resolv.conf.
FAQ
هل يستحق تشغيل k3s على خادم VPS واحد؟
يستحق الأمر ذلك عندما تحتاج إلى واجهة برمجة تطبيقات Kubernetes: للتعلم على جهاز تتحكم به، أو للحفاظ على قابلية نقل عمليات النشر كملفات manifests، أو لتشغيل برمجيات لا توفر سوى Helm chart، أو لبناء شيء ستنقله لاحقاً إلى عنقود مدار. لا يستحق الأمر ذلك إذا كنت تريد فقط تشغيل حاويات، لأن Docker Compose يؤدي هذه المهمة بجهد صيانة أقل بكثير وتوفير حوالي جيجابايت إضافي من ذاكرة الوصول العشوائي (RAM). العقدة الواحدة لا توفر لك توافرية عالية، لذا فإن الموثوقية ليست سبباً لاختيارها أبداً.
لماذا تظل خدمة LoadBalancer في k3s بحالة Pending؟
تنشئ ServiceLB وحدات svclb- (pods) تحجز منافذ الخدمة كـ hostPort على العقدة، لذا فهي لا تُجدول إلا حيث تكون تلك المنافذ متاحة. إذا كان هناك pod آخر في Kubernetes يحجز نفس الـ hostPort مسبقاً، تظل الـ pod في حالة Pending ولا تحصل الخدمة أبداً على عنوان خارجي. لا يتسبب وكيل (proxy) مضيف أو حاوية 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 الخاص بالـ pod المتعارض، أو عطّل ServiceLB باستخدام --disable=servicelb وقم بتوجيه الطلبات (proxy) إلى الـ NodePort الذي لا تزال الخدمة تخصص له منفذاً.
ما مقدار ذاكرة الوصول العشوائي (RAM) التي يحتاجها k3s على خادم VPS؟
الحد الأدنى الموثق لعقدة الخادم هو معالجان و 2 جيجابايت، وهذا يغطي k3s ومكوناته المدمجة قبل إضافة أعباء العمل الخاصة بك. قيست مستويات أداء المشروع لعقدة الخادم بـ 1,596 ميجابايت أثناء تشغيل حزمة مراقبة، وهذا الرقم لا يشمل ذاكرة أعباء العمل نفسها، لذا اعتبر 2 جيجابايت حداً أدنى و 4 جيجابايت كأول حجم تكون فيه العقدة الواحدة مريحة. قِس استهلاك جهازك باستخدام free -h قبل التثبيت ومرة أخرى بعد أن تصبح كل الـ pods في kube-system بحالة Running.
هل يمكنني تشغيل Docker و k3s على نفس خادم VPS؟
نعم، وهما يبقيان منفصلين. يستخدم k3s محرك containerd المدمج الخاص به، لذا فإن أي صورة (image) تُبنى باستخدام docker build لن تكون مرئية له إلا بعد تشغيل docker save myapp:0.1 | sudo k3s ctr images import -. يقوم كل منهما أيضاً بكتابة قواعد iptables الخاصة به وشبكات الجسر (bridge networks) الخاصة به. راقب إجمالي الذاكرة، لأن Docker و k3s وحاوياتك جميعها تتشارك في ذاكرة الجهاز.
كيف أحذف k3s تماماً؟
شغّل sudo /usr/local/bin/k3s-uninstall.sh على عقدة الخادم، أو sudo /usr/local/bin/k3s-agent-uninstall.sh على العميل (agent). سيؤدي ذلك إلى إيقاف الخدمة، وحذف مخزن البيانات، وحذف بيانات وحدات التخزين الدائمة (persistent volumes) الموجودة تحت /var/lib/rancher/k3s/storage، وإزالة الأدوات المجمعة. انسخ أي بيانات تريد الاحتفاظ بها خارج الجهاز أولاً، لأنه لا يوجد تراجع عن هذه العملية. ستختفي واجهة الشبكة cni0 أو flannel.1 المتبقية عند إعادة التشغيل التالية.