SSD Nodes Learn Hosting plans →
تعلیمی Matt Connorتحریر: Matt Connor

VPS پر single-node k3s کب واقعی فائدہ مند ہے؟

k3s ایک VPS پر حقیقی Kubernetes API دیتا ہے، مگر RAM کی قیمت، install میں port 80 کا تصادم، اور وہ حالات جانیں جب Docker Compose بہتر انتخاب رہتا ہے۔

k3s کیا ہے، اور اس کا ایک node آپ کو کیا فراہم کرتا ہے

k3s ایک مکمل Kubernetes distribution ہے جو ایک binary کے طور پر package کی جاتی ہے۔ اسے ایک single VPS پر چلانے سے آپ کو حقیقی Kubernetes API ملتی ہے، اور تین machine والے control plane کی ضرورت نہیں رہتی۔ یہ ایک certified Kubernetes distribution ہے، اس لیے یہاں apply ہونے والا manifest بعد میں managed cluster پر بھی apply ہو جاتا ہے۔ installation ایک command ہے اور تقریباً ایک منٹ لیتی ہے۔ اس کے بدلے آپ کی کچھ memory applications کے لیے دستیاب نہیں رہتی، اور failure modes کا ایک مجموعہ شامل ہو جاتا ہے جو Docker Compose میں کبھی پیش نہیں آتے۔

SUSE نے k3s کو edge sites اور چھوٹی installations کے لیے بنایا ہے۔ upstream Kubernetes سے اس کے اختلافات اسے کم حجم اور چلانے میں آسان بنانے کے لیے ہیں۔ default datastore etcd کے بجائے kine نامی shim کے پیچھے sqlite ہے، اس لیے etcd quorum برقرار رکھنے کی ضرورت نہیں ہوتی۔ containerd الگ install ہونے کے بجائے binary میں embedded ہے۔ یہی binary cluster DNS کے لیے CoreDNS، ingress controller کے طور پر Traefik، اور ServiceLB بھی فراہم کرتی ہے، جسے klipper-lb بھی کہا جاتا ہے، تاکہ کسی cloud provider کے بغیر LoadBalancer services کام کریں۔ اس میں persistent volumes کے لیے local-path provisioner، metrics-server، اور pod networking کے لیے flannel بھی شامل ہیں۔ یہ تمام components default طور پر start ہوتے ہیں۔ یہ defaults Traefik کو ports 80 اور 443 پر چلا دیتے ہیں، اس لیے اس VPS پر install کرنے سے پہلے طے کریں کہ ان ports کا استعمال کون کرے گا، خاص طور پر اگر VPS پہلے سے کوئی سروس فراہم کر رہا ہو۔

ایک واحد k3s node کب مناسب ہے

یہ اصول استعمال کریں۔ جب آپ کو Kubernetes API درکار ہو تو k3s چلائیں: آپ اپنے زیرِ انتظام machine پر Kubernetes سیکھ رہے ہوں، یا مطلوبہ software صرف Helm chart شائع کرتا ہو۔ Manifest کی portability بھی اہم ہے، کیونکہ یہاں لکھا گیا Deployment بغیر تبدیلی کے managed cluster میں منتقل کیا جا سکتا ہے۔ جب آپ کو applications درکار ہوں تو Docker Compose چلائیں۔ Compose بہت کم اجزا کے ساتھ وہی containers شروع کرتا ہے، اور VPS پر موجود Compose file کو ایک سال بعد manifests کی directory کے مقابلے میں سمجھنا آسان ہوتا ہے۔

واضح رہے کہ ایک node آپ کو کیا فراہم نہیں کرتا۔

  • High availability نہیں ہوتی۔ VPS reboot ہونے پر ہر workload رک جاتا ہے۔ Kubernetes کسی pod کو دوسرے node پر reschedule کرتا ہے، لیکن یہاں کوئی دوسرا node موجود نہیں۔
  • ایسا rolling update نہیں ہوتا جو service کو چلتا رکھے، الا یہ کہ application ایک ہی machine پر دو replicas چلنے کو برداشت کرے اور node دونوں کے لیے کافی وسائل رکھتا ہو۔
  • Storage اسی machine سے وابستہ رہتی ہے، جیسا کہ ذیل کے local-path section میں بیان کیا گیا ہے۔
  • Control plane تقریباً ایک gigabyte RAM استعمال کرتا ہے، چاہے آپ کچھ deploy کریں یا نہ کریں۔

ان میں سے کوئی بات k3s کو برا انتخاب نہیں بناتی۔ البتہ reliability کی وہ وجہ غلط ثابت ہوتی ہے جو لوگ عموماً پیش کرتے ہیں۔ اگر آپ کی اصل ضرورت کئی machines ہیں تاکہ ایک حقیقی multi-node cluster بنایا جا سکے، تو یہ فیصلہ پہلے کریں: اپنے hardware پر Proxmox یا rented VPS یہ طے کرتا ہے کہ nodes کہاں سے آئیں گے، اس سے پہلے کہ k3s یہ طے کرے کہ ان پر کیا چلے گا۔

کسی بھی چیز کو deploy کرنے سے پہلے k3s کے RAM اور CPU اخراجات

k3s project اندازوں کے بجائے ناپی گئی شماریات شائع کرتا ہے۔ انہیں احتیاط سے پڑھیں، کیونکہ عام طور پر بیان کیا جانے والا عدد idle k3s کا عدد نہیں ہے۔

چارٹPublished k3s resource use, 95th percentile, Intel 8375C, k3s v1.26.5
اس چارٹ کے پیچھے کا ڈیٹا
[
  {
    "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
  }
]

اس test میں server node نے 95th percentile پر 1,596 MB RAM اور ایک core کی تقریباً 6 فیصد CPU استعمال کی۔ یہ شائع شدہ اعداد ہیں، اس guide میں کی گئی پیمائش نہیں۔ test میں k3s v1.26.5 چلایا گیا، جس میں تمام packaged components enabled تھے، اور ساتھ Prometheus اور Grafana monitoring stack بھی چل رہا تھا۔ اس لیے cluster خالی نہیں بلکہ مصروف تھا۔ تاہم project کے مطابق یہ اعداد صرف Kubernetes datastore اور control plane کا احاطہ کرتے ہیں اور workload-specific ضروریات شامل نہیں کرتے۔ آپ کے اپنے containers اس کے علاوہ وسائل استعمال کریں گے۔ sqlite کو embedded etcd سے تبدیل کرنے پر استعمال 1,606 MB ہو گیا۔ agent node، جو control plane کے بغیر kubelet اور containerd چلاتا ہے، نے 275 MB استعمال کیا۔ server کے لیے دستاویزی minimum 2 cores اور 2 GB RAM ہے۔ یہ minimum آپ کے workloads سے پہلے k3s اور اس کے packaged components کا احاطہ کرتا ہے۔

عملی مطلب یہ ہے کہ 2 GB VPS پر control plane اور اس کے bundled add-ons آپ کے لیے بہت کم وسائل چھوڑتے ہیں۔ memory pressure کے دوران kubelet pods کو evict کرتا ہے، لیکن اگر memory usage تیزی سے بڑھے تو kubelet کے pressure کا پتا لگانے سے پہلے kernel کا OOM killer کارروائی کر سکتا ہے۔ ایک node پر چند چھوٹی services کے لیے 4 GB ایک مناسب بنیادی حد ہے۔ کسی بھی شائع شدہ figure، بشمول اس figure، پر مکمل اعتماد کرنے کے بجائے اپنے box کی پیمائش کریں۔

free -h
sudo k3s kubectl top node
sudo k3s kubectl get pods -A

install کرنے سے پہلے اور پھر اس وقت free -h چلائیں جب kube-system میں موجود ہر pod کا status Running ہو جائے۔ دونوں پیمائشوں کا فرق آپ کے hardware پر control plane کی لاگت ظاہر کرتا ہے۔ install کے بعد پہلے ایک یا دو منٹ میں k3s kubectl top node، error: Metrics API not available واپس کرتا ہے، کیونکہ metrics-server نے ابھی کچھ scrape نہیں کیا ہوتا۔ یہ fault نہیں ہے۔ اگر آپ ایک ہی وقت میں اس box کو اس کام اور دوسرے کاموں کے لیے استعمال کرنے کی sizing کر رہے ہیں تو VPS کے لیے RAM اور CPU کی sizing کا حساب یہاں بھی بغیر تبدیلی کے لاگو ہوتا ہے۔

ریلیز کو latest کے بجائے مقررہ version پر k3s انسٹال کریں

جلد آغاز کے لیے جو command سب نقل کرتے ہیں، وہ اس دن stable channel جس version کی طرف اشارہ کر رہا ہو، وہی انسٹال کرتی ہے۔ جس machine کو آپ برقرار رکھنے کا ارادہ رکھتے ہیں، اس پر version pin کریں۔ k3s ہر Kubernetes minor version کے لیے الگ channel جاری کرتا ہے، اس لیے INSTALL_K3S_CHANNEL=v1.36 v1.36 کے اندر patch releases کی پیروی کرتا ہے اور خود سے minor version تبدیل نہیں کرتا۔ October 2026 تک stable channel v1.36.5+k3s1 کی طرف اشارہ کرتا ہے۔

پہلے config file لکھیں، پھر انسٹال کریں۔ k3s شروع ہوتے وقت /etc/rancher/k3s/config.yaml پڑھتا ہے، اس لیے اس میں موجود ہر setting پہلی boot اور اس کے بعد کی تمام boots پر بھی لاگو ہوتی ہے۔

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 -

channel کے بجائے کسی ایک exact release کو pin کرنے کے لیے INSTALL_K3S_VERSION=v1.36.5+k3s1 استعمال کریں۔ plus sign tag کا حصہ ہے۔ اس کے بعد تصدیق کریں کہ یہ شروع ہو گیا ہے۔

k3s --version
sudo systemctl status k3s
sudo k3s kubectl get node
sudo k3s kubectl get pods -A

kubectl get node کو تقریباً thirty seconds کے اندر STATUS Ready کے ساتھ ایک node دکھانا چاہیے، اور kube-system کے ہر pod کو Running یا Completed state تک پہنچنا چاہیے۔ NotReady پر رکا ہوا node عموماً اس بات کی نشاندہی کرتا ہے کہ container runtime شروع نہیں ہوا، اس لیے sudo journalctl -u k3s -n 100 --no-pager پڑھیں۔ غیر معمولی VPS image پر، کسی اور چیز کی debugging سے پہلے sudo k3s check-config چلائیں۔ یہ missing kernel features کی رپورٹ دیتا ہے، جو logs پڑھنے کے مقابلے میں کہیں تیز طریقہ ہے۔

پہلے سے استعمال ہونے والے port 80 کی وجہ اور اسے درست کرنے کے لیے کیا ترک کرنا ہوگا

یہ مسئلہ اس VPS پر سامنے آتا ہے جہاں پہلے سے کوئی سروس چل رہی ہو۔ Installation کامیاب ہو جاتی ہے، لیکن اگر واحد node پر کوئی دوسرا Kubernetes pod وہی hostPort پہلے سے reserve کر چکا ہو تو Traefik کو کبھی address نہیں ملتا۔

طریقۂ کار یہ ہے: bundled Traefik chart، ports 80 اور 443 پر LoadBalancer قسم کی Service بناتا ہے۔ ServiceLB اس درخواست کے جواب میں چھوٹے pods کا DaemonSet بناتا ہے۔ ان pods کے نام svclb- prefix سے شروع ہوتے ہیں، اور یہ ہر node پر ان port numbers کو hostPort کے طور پر claim کرتے ہیں۔ hostPort، network rules کے ذریعے node port سے pod تک traffic forward کرتا ہے۔ Scheduler صرف Kubernetes pods کے declared host ports کو check کرتا ہے۔ یہ host services یا standalone Docker containers کے زیرِ استعمال sockets کو check نہیں کرتا۔ اگر کوئی دوسرا pod وہی hostPort reserve کرے تو scheduling رک جاتی ہے۔ nginx، Caddy، Apache یا port 80 پر listening کرنے والا standalone Docker container خود اس scheduling rejection کی وجہ نہیں بنتا۔

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 )'

اگر کسی دوسرے Kubernetes pod نے متصادم hostPort reserve کیا ہو تو svclb pod کو Pending حالت میں اور Service کو external address کے بغیر دیکھیں گے:

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 بتاتا ہے کہ port پر کون سا process listening کر رہا ہے؛ یہ وہ hostPort reservations نہیں دکھاتا جنہیں scheduler check کرتا ہے۔ اس مسئلے کے ایک سے زیادہ حل ہیں، اور ہر حل میں آپ کو کچھ ترک کرنا ہوگا۔

Ports k3s کو دے دیں۔ دوسرے Kubernetes pod سے متصادم hostPort reservation ہٹا دیں، اور موجودہ host web server کو stop اور disable کر دیں تاکہ Traefik ports 80 اور 443 پر آنے والا traffic سنبھالے۔ جب VPS صرف k3s کے لیے ہو اور آپ کی تمام موجودہ سروسز Ingress کے پیچھے منتقل ہونے والی ہوں، تو یہی درست انتخاب ہے۔

ServiceLB disable کریں اور موجودہ proxy برقرار رکھیں۔ Installation کے وقت --disable=servicelb استعمال کریں۔ LoadBalancer قسم کی Service پھر بھی NodePort allocate کرتی ہے، اس لیے Traefik کسی بلند port، مثلاً 31480، پر قابلِ رسائی رہتا ہے، اور آپ کا nginx یا Caddy 127.0.0.1:31480 کو proxy کرتا ہے۔ اس صورت میں آپ external address ترک کرتے ہیں: Service ہمیشہ <pending> دکھاتی رہے گی۔ یہ خرابی نہیں بلکہ آپ کا کیا ہوا انتخاب ہے، اگرچہ بظاہر خرابی لگ سکتا ہے۔

Traefik disable کریں اور اپنے proxy سے routing کریں۔ Installation کے وقت --disable=traefik استعمال کریں۔ اس کے بعد آپ کے پاس ingress controller نہیں ہوگا، اس لیے Ingress objects بالکل کوئی کام نہیں کریں گے۔ وہ API میں موجود رہیں گے، لیکن ان پر نظر رکھنے والا کوئی controller نہیں ہوگا۔ اگر آپ host proxy سے NodePorts تک routing کر رہے ہوں تو یہ طریقہ مناسب ہے۔ اگر آپ پہلے ہی جانتے ہیں کہ HTTP کو کیسے handle کرنا ہے تو یہ واضح اور درست انتخاب ہے۔ اگر آپ نے ابھی فیصلہ نہیں کیا کہ سامنے کیا ہونا چاہیے، تو کچھ disable کرنے سے پہلے nginx، Caddy اور Traefik میں reverse proxy کے لیے انتخاب طے کریں۔

دونوں flags installer کے ساتھ یا config file میں دیے جا سکتے ہیں:

tls-san:
  - k3s.example.com
disable:
  - traefik
  - servicelb

Installation کے بعد اس file میں ترمیم کرکے sudo systemctl restart k3s چلانا بھی کام کرتا ہے، کیونکہ --disable صرف installation کے وقت کسی component کو skip نہیں کرتا۔ یہ پہلے سے deployed component کو delete بھی کرتا ہے، اس لیے تبدیلی running cluster پر نافذ ہو جاتی ہے۔

Traefik برقرار رکھتے ہوئے chart کی configuration تبدیل کرنے کے لیے /var/lib/rancher/k3s/server/manifests/traefik.yaml میں ترمیم نہ کریں۔ k3s ہر بار start ہونے پر اس file کو defaults کے ساتھ دوبارہ لکھ دیتا ہے۔ اس کے بجائے اسی directory میں الگ file شامل کریں، کیونکہ /var/lib/rancher/k3s/server/manifests میں موجود ہر چیز startup کے وقت اور disk پر اس میں تبدیلی ہونے پر خودکار طور پر apply ہو جاتی ہے۔

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 chart کی ایک value، یعنی trusted proxy addresses، set کرتی ہے۔ یہی mechanism chart کی فراہم کردہ دیگر values بھی set کر سکتا ہے، جن میں اس کے ports بھی شامل ہیں۔

ایک نوڈ پر مستقل اسٹوریج

k3s میں local-path نام کی ایک default StorageClass شامل ہوتی ہے، جسے Rancher's local-path provisioner چلاتا ہے۔ جس PersistentVolumeClaim میں storageClassName نہ ہو، اسے یہی StorageClass ملتی ہے۔ Volumes /var/lib/rancher/k3s/storage میں رہتے ہیں، اور ہر volume کے لیے نوڈ کی اپنی disk پر ایک الگ subdirectory ہوتی ہے۔

sudo k3s kubectl get storageclass
sudo k3s kubectl get pvc -A
sudo ls -l /var/lib/rancher/k3s/storage

"نوڈ کی اپنی disk پر" ہونے کے دو نتائج ہیں، اور دونوں کا اثر آج کے بجائے بعد میں ظاہر ہوتا ہے۔

StorageClass میں volumeBindingMode: WaitForFirstConsumer استعمال ہوتا ہے، اس لیے نیا PVC اس وقت تک Pending رہتا ہے جب تک کوئی pod اسے mount نہ کرے۔ kubectl describe pvc یہ دکھاتا ہے:

waiting for first consumer to be created before binding

یہ معمول کی بات ہے۔ اس لیے صرف PVC بنانا اور انتظار کرنا اسے Pending سے نہیں نکالے گا۔

Bind ہونے کے بعد volume میں اس نوڈ کے لیے node affinity شامل ہو جاتی ہے جس نے اسے بنایا تھا۔ اس سے اس claim کو استعمال کرنے والا ہر pod volume کی پوری مدت تک اسی نوڈ سے وابستہ رہتا ہے۔ ایک نوڈ پر آپ کو یہ کبھی محسوس نہیں ہوگا۔ بعد میں دوسرا نوڈ شامل کرنے پر اگر کوئی pod دوسرے نوڈ پر منتقل نہ ہو تو یہ scheduler bug معلوم ہو سکتا ہے، جب تک آپ kubectl get pv -o yaml نہ چلائیں اور nodeAffinity میں موجود hostname نہ دیکھ لیں۔

Backups کی ذمہ داری آپ کی ہے۔ VPS کو دوبارہ بنانا اس directory کو ختم کر دیتا ہے، اور نیچے دیا گیا uninstall script بھی یہی کرتا ہے۔ /var/lib/rancher/k3s/storage کا backup لیں۔ اس کے علاوہ sqlite datastore directory /var/lib/rancher/k3s/server/db/ کا بھی backup لیں، مگر اسے service روکنے کے بعد copy کریں کیونکہ یہ live database ہے۔ Server token file /var/lib/rancher/k3s/server/token بھی محفوظ کریں۔ یہ token اختیاری نہیں ہے۔ k3s کی دستاویزات کے مطابق backup سے datastore بحال کرتے وقت آپ کو یہ file restore کرنی ہوگی، یا اس کی value --token کو دینی ہوگی۔ متبادل یہ ہے کہ cluster کو disposable سمجھیں اور ہر manifest کو git میں محفوظ رکھیں۔

Ingress اور TLS

جب Traefik فعال ہو تو ایک standard Ingress object ہی کافی ہے۔

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

Certificates خود بخود ظاہر نہیں ہوتے۔ معمول کا حل cert-manager ہے، جسے اس کے published manifest سے install کیا جاتا ہے، اور اس کے ساتھ ایک ClusterIssuer درکار ہوتا ہے۔ Version v1.21.3، جو 23 October 2026 کو release ہوا، October 2026 تک موجودہ version ہے۔

sudo k3s kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.21.3/cert-manager.yaml
apiVersion: 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 challenge میں ACME (automatic certificate management environment) server public internet سے http://hello.example.com/.well-known/acme-challenge/... سے connect کرتا ہے۔ اس لیے hostname کا DNS record، یعنی A record یا AAAA record اگر VPS تک IPv6 کے ذریعے رسائی ممکن ہو، پہلے سے VPS کی طرف point ہونا چاہیے، اور port 80 کو Traefik تک پہنچنا چاہیے۔ جب دونوں موجود ہوں تو Let's Encrypt پہلے IPv6 address آزماتا ہے، لیکن ابتدائی IPv6 connection timeout ہونے پر IPv4 پر fallback کرتا ہے۔ دیگر errors، جن میں غلط challenge response بھی شامل ہے، اس fallback کو trigger نہیں کرتیں، اور redirected requests کو دوبارہ کوشش نہیں ملتی۔ پرانا AAAA record درست کریں یا اسے remove کریں۔ اگر آپ نے ServiceLB disabled کیا ہے اور اس کے سامنے اپنا proxy رکھا ہے تو اس proxy کو challenge path بھی forward کرنا ہوگا، ورنہ cert-manager Challenge object پر یہ message دکھا کر رک جاتا ہے:

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 سے certificate issuance monitor کریں۔

kubeconfig کیا ہے، اور API server نجی کیوں رہتا ہے

k3s منتظم کے credentials کو /etc/rancher/k3s/k3s.yaml میں لکھتا ہے۔ یہ file root کی ملکیت ہوتی ہے اور default طور پر mode 600 کے ساتھ لکھی جاتی ہے۔ اس میں cluster-admin اختیارات والا client certificate موجود ہوتا ہے، اس لیے جو بھی اسے پڑھ سکتا ہے وہ پورے cluster کو control کر سکتا ہے۔

sudo k3s kubectl get node
export KUBECONFIG=/etc/rancher/k3s/k3s.yaml
kubectl get node

الگ سے نصب کیا گیا kubectl، k3s کی file کو خودکار طور پر نہیں پہچانتا۔ KUBECONFIG مقرر نہ ہو تو یہ ~/.kube/config کو پڑھتا ہے، اور اگر وہ file موجود نہ ہو تو The connection to the server localhost:8080 was refused - did you specify the right host or port? کے ساتھ fail ہو جاتا ہے، کیونکہ اس میں کوئی cluster configured نہیں ہوتا۔ KUBECONFIG مقرر کریں، نیچے دکھائے گئے طریقے کے مطابق file کو ~/.kube/config میں copy کریں، یا sudo k3s kubectl استعمال کریں، جو خود درست file پڑھ لیتا ہے۔

آپ دیکھیں گے کہ --write-kubeconfig-mode 644 کی سفارش کی جاتی ہے تاکہ عام user kubectl چلا سکے۔ سمجھیں کہ اس سے کیا ہوتا ہے: cluster-admin credential مشین کے ہر local account کے لیے قابلِ مطالعہ ہو جاتا ہے۔ single-admin machine پر یہ قابلِ قبول سمجھوتا ہو سکتا ہے۔ shared machine پر یہ مناسب نہیں ہے۔ file کو copy کرنے سے اسے عام طور پر شائع کیے بغیر صرف ایک user کو access ملتا ہے:

mkdir -p ~/.kube
sudo install -o $USER -g $USER -m 600 /etc/rancher/k3s/k3s.yaml ~/.kube/config

اس file میں server: کی line، https://127.0.0.1:6443 کو پڑھتی ہے۔ اپنے laptop سے kubectl استعمال کرنے کے لیے 6443 کو internet پر open نہ کریں۔ public Kubernetes API مسلسل حملوں کا ہدف بن سکتی ہے، اور exposed API کی وجہ سے چھوٹے clusters کسی دوسرے شخص کے لیے cryptocurrency mine کرنے لگتے ہیں۔ اسے SSH کے ذریعے tunnel کریں اور file میں موجود address کو تبدیل نہ کریں:

ssh -N -L 6443:127.0.0.1:6443 user@your-vps
KUBECONFIG=./k3s.yaml kubectl get node

اگر آپ کو private network address کے ذریعے API تک رسائی درکار ہو تو tls-san کے ساتھ install کرتے وقت وہ name یا address درج کریں، پھر copied file کی server: line کو اسی کے مطابق تبدیل کریں۔ SAN (subject alternative name) entry کے بغیر kubectl connection مسترد کر دیتا ہے:

x509: certificate is valid for 127.0.0.1, 10.43.0.1, not 203.0.113.10

cluster کے لیے دستاویزی inbound ports API کے لیے TCP 6443، nodes کے درمیان flannel VXLAN کے لیے UDP 8472، اور kubelet metrics کے لیے TCP 10250 ہیں۔ single-node cluster میں ان میں سے کسی port کو internet کے لیے open رکھنے کی ضرورت نہیں ہے۔

containerd، Docker نہیں ہے

k3s اپنا embedded containerd چلاتا ہے، اور یہ Docker کے ساتھ image store شیئر نہیں کرتا۔ آپ نے ابھی docker build سے جو image build کی ہے، وہ k3s کو نظر نہیں آتی۔ اس لیے pod ErrImagePull کے ساتھ fail ہو جاتا ہے، حالانکہ docker images اسے فہرست میں دکھاتا ہے۔ اسے واضح طور پر import کریں:

docker save myapp:0.1 | sudo k3s ctr images import -
sudo k3s crictl images

اس container پر :latest tag استعمال نہ کریں، کیونکہ :latest بطور ڈیفالٹ Always کے imagePullPolicy پر set ہوتا ہے، اور kubelet پھر بھی registry سے image حاصل کرنے کی کوشش کرتا ہے۔ کسی بھی دوسرے tag کا default IfNotPresent ہوتا ہے، جو آپ کی import کی ہوئی image استعمال کرتا ہے۔ ایک ہی VPS پر دونوں کو چلایا جا سکتا ہے۔ یہ بات سمجھنا مفید ہے کہ VPS پر عام Docker installation اور k3s، دونوں اسی machine پر اپنا الگ image store اور اپنے الگ iptables rules رکھتے ہیں۔

k3s کو کیسے ہٹائیں

installer ایک uninstall script لکھتا ہے۔ جزوی removal یا undo کی سہولت موجود نہیں ہے۔

sudo /usr/local/bin/k3s-uninstall.sh

یہ service کو روکتا اور ہٹاتا ہے، datastore حذف کرتا ہے، persistent volume data حذف کرتا ہے، node configuration ہٹاتا ہے، اور installer کے شامل کردہ tools بھی ہٹا دیتا ہے۔ agent node پر script اس کے بجائے k3s-agent-uninstall.sh ہوتی ہے۔ پہلے /var/lib/rancher/k3s/storage کے اندر موجود ہر چیز کو اس machine سے باہر copy کر لیں، کیونکہ یہ directory بھی حذف ہو جاتی ہے۔ اس کے بعد ip link show اور sudo ss -lntp سے تصدیق کریں کہ کوئی process ports یا interfaces پر قبضہ برقرار نہیں رکھے ہوئے۔ باقی رہ جانے والا cni0 یا flannel.1 interface اگلے reboot پر ختم ہو جاتا ہے۔

یہ فیصلہ کرنا کہ Kubernetes کا ایک node کام کی ضرورت سے زیادہ پیچیدہ نکلا، ناکامی نہیں بلکہ ایک معمول کا نتیجہ ہے۔ ان workloads کو واپس Compose پر منتقل کرنا عموماً ایک دوپہر میں مکمل ہو جاتا ہے۔

خرابی کی صورتیں اور وہ strings جو آپ دیکھیں گے

Node NotReady، یا k3s بار بار restart ہو رہا ہے۔ پہلے sudo journalctl -u k3s -n 200 --no-pager پڑھیں۔ چھوٹے VPS پر عام وجہ kernel کا out-of-memory killer ہوتا ہے، جو process کو ختم کر دیتا ہے۔ dmesg میں یہ k3s-server کا نام دینے والی سطر کے طور پر ظاہر ہوتا ہے۔ دستاویز میں دی گئی 2 GB کی کم از کم حد واقعی عملی کم از کم حد ہے۔

Pod Pending میں پھنسا ہوا ہے۔ kubectl describe pod ہر بار وجہ بتاتا ہے۔ Insufficient memory یا Insufficient cpu کا مطلب ہے کہ node پر مزید گنجائش نہیں رہی۔ didn't have free ports کا مطلب ہے کہ کوئی دوسرا Kubernetes pod متصادم hostPort reserve کر رہا ہے۔ PVC پر waiting for first consumer کا مطلب ہے کہ WaitForFirstConsumer درست طور پر کام کر رہا ہے۔

ImagePullBackOff۔ node image pull نہیں کر سکا۔ image کا نام اور tag، registry تک رسائی اور credentials چیک کریں۔ یہ بھی دیکھیں کہ کہیں image Docker سے build کر کے containerd میں import کرنا تو نہیں بھول گئے۔

Traefik جواب دیتا ہے، لیکن app نہیں۔ 404 page not found کا response body خود Traefik کی طرف سے آتا ہے۔ اس کا مطلب ہے کہ request پہنچ گئی، لیکن کسی router سے match نہیں ہوئی۔ تصدیق کریں کہ Ingress host اس نام سے match کرتا ہے جو آپ نے درج کیا ہے، اور ingressClassName، traefik ہے۔

Cluster DNS ناکام ہے، جبکہ host درست طور پر resolve ہو رہا ہے۔ sudo k3s kubectl -n kube-system logs -l k8s-app=kube-dns سے CoreDNS چیک کریں۔ plugin/loop: Loop ... detected for zone "." جیسا message CoreDNS کو start ہونے سے روک دیتا ہے۔ ایسا اس لیے ہوتا ہے کہ CoreDNS ایسے resolver کو forward کر رہا ہوتا ہے جو request دوبارہ اسی کی طرف forward کرتا ہے۔ /etc/resolv.conf میں loopback address یہی مسئلہ پیدا کرتا ہے۔ --resolv-conf /run/systemd/resolve/resolv.conf کے ذریعے k3s کو اصل upstream file استعمال کرنے کے لیے configure کریں۔

FAQ

کیا ایک ہی VPS پر k3s چلانا مفید ہے؟

یہ اس وقت مفید ہے جب آپ کو Kubernetes API درکار ہو: اپنے زیرِ انتظام machine پر اسے سیکھنے کے لیے، deployments کو manifests کی صورت میں قابلِ منتقلی رکھنے کے لیے، ایسا software چلانے کے لیے جو صرف Helm chart فراہم کرتا ہو، یا ایسی چیز بنانے کے لیے جسے بعد میں managed cluster میں منتقل کرنا ہو۔ اگر آپ صرف containers چلانا چاہتے ہیں تو یہ مفید نہیں، کیونکہ Docker Compose بہت کم انتظامی کام کے ساتھ یہی کام کرتا ہے اور تقریباً ایک gigabyte زیادہ free RAM دستیاب رکھتا ہے۔ ایک node آپ کو high availability نہیں دیتا، اس لیے reliability اسے منتخب کرنے کی وجہ نہیں بنتی۔

میری k3s LoadBalancer service Pending کیوں رہتی ہے؟

ServiceLB ایسے svclb- pods بناتا ہے جو node پر service کے ports کو hostPort کے طور پر reserve کرتے ہیں، اس لیے یہ صرف وہاں schedule ہوتے ہیں جہاں وہ ports خالی ہوں۔ اگر کوئی دوسرا Kubernetes pod وہی hostPort پہلے ہی reserve کر چکا ہو تو pod Pending رہتا ہے اور service کو external address نہیں ملتا۔ port 80 پر listening کرنے والا host proxy یا standalone Docker container خود اس scheduling rejection کا سبب نہیں بنتا۔ 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 رپورٹ کرتا ہے۔ متصادم pod کی hostPort reservation ختم کریں، یا --disable=servicelb کے ذریعے ServiceLB disable کریں اور اس NodePort پر proxy کریں جو service بدستور allocate کرتی ہے۔

VPS پر k3s کو کتنی RAM درکار ہوتی ہے؟

server node کے لیے documented minimum 2 cores اور 2 GB ہے، اور یہ آپ کے workloads سے پہلے k3s اور اس کے packaged components کے لیے کافی ہے۔ project کی اپنی profiling کے مطابق، monitoring stack چلنے کے دوران server node کا control plane اور datastore 1,596 MB استعمال کرتے تھے۔ اس figure میں workload کی اپنی memory شامل نہیں، اس لیے 2 GB کو کم از کم حد اور 4 GB کو وہ پہلا size سمجھیں جس پر ایک node اطمینان سے چلتا ہے۔ اپنے box کی پیمائش install سے پہلے اور پھر kube-system کے ہر pod کے Running ہونے کے بعد free -h کے ذریعے کریں۔

کیا میں اسی VPS پر Docker اور k3s چلا سکتا ہوں؟

ہاں، اور دونوں الگ رہتے ہیں۔ k3s اپنا embedded containerd استعمال کرتا ہے، اس لیے docker build کے ذریعے بنائی گئی image اس وقت تک اسے نظر نہیں آتی جب تک آپ docker save myapp:0.1 | sudo k3s ctr images import - نہ چلائیں۔ دونوں اپنی الگ iptables rules اور اپنی الگ bridge networks بھی بناتے ہیں۔ memory total پر نظر رکھیں، کیونکہ Docker، k3s اور آپ کے containers سب اسی box کی RAM استعمال کرتے ہیں۔

میں k3s کو مکمل طور پر کیسے ہٹاؤں؟

server node پر sudo /usr/local/bin/k3s-uninstall.sh یا agent پر sudo /usr/local/bin/k3s-agent-uninstall.sh چلائیں۔ یہ service روکتا ہے، datastore حذف کرتا ہے، /var/lib/rancher/k3s/storage کے تحت persistent volume data حذف کرتا ہے، اور bundled tools ہٹا دیتا ہے۔ جس data کو محفوظ رکھنا چاہتے ہیں اسے پہلے box سے باہر copy کر لیں، کیونکہ اس عمل کو واپس نہیں کیا جا سکتا۔ باقی رہ جانے والا cni0 یا flannel.1 network interface اگلے reboot پر ختم ہو جاتا ہے۔

کیا یہ مضمون مفید تھا؟

#kubernetes#k3s#docker-compose#ingress#sizing