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 हे एकाच binary म्हणून packaged केलेले पूर्ण Kubernetes distribution आहे. ते एका VPS वर चालवल्यास तीन-मशीन control plane शिवाय तुम्हाला प्रत्यक्ष Kubernetes API मिळतो. हे certified Kubernetes distribution आहे. त्यामुळे येथे लागू होणारा manifest नंतर managed cluster वरही लागू करता येतो. Installation साठी एक command लागते आणि साधारण एक मिनिट लागतो. यासाठी तुमच्या applications साठी उपलब्ध memory कमी होते. तसेच Docker Compose मध्ये कधीही न येणाऱ्या काही failure modes चा सामना करावा लागतो.

SUSE edge sites आणि small installations साठी k3s तयार करते. Upstream Kubernetes मधील त्याचे फरक ते अधिक लहान आणि चालवायला सोपे करण्यासाठी आहेत. Default datastore sqlite आहे. तो kine नावाच्या shim मागे वापरला जातो; etcd वापरले जात नाही. त्यामुळे etcd quorum maintain करण्याची गरज नसते. containerd binary मध्ये embedded आहे; ते स्वतंत्रपणे install करावे लागत नाही. त्याच binary मध्ये cluster DNS साठी CoreDNS, ingress controller म्हणून Traefik, cloud provider नसतानाही LoadBalancer services चालण्यासाठी ServiceLB (याला klipper-lb असेही म्हणतात), persistent volumes साठी local-path provisioner, metrics-server आणि pod networking साठी flannel यांचाही समावेश आहे. हे सर्व components default ने सुरू होतात. या defaults मुळे Traefik ports 80 आणि 443 वर येतो. त्यामुळे आधीपासून काही सेवा देत असलेल्या VPS वर install करण्यापूर्वी हे ports कोण वापरणार ते ठरवा.

एकच k3s node कधी योग्य ठरतो

हा नियम वापरा. तुम्हाला Kubernetes API हाच मुख्य उद्देश असेल तेव्हा k3s चालवा: तुम्ही स्वतः नियंत्रित करत असलेल्या मशीनवर 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 वर पुन्हा schedule करते; परंतु येथे दुसरा nodeच नसतो.
  • Service सुरू ठेवणारा rolling update मिळत नाही, जोपर्यंत application एकाच मशीनवर दोन replicas चालवू शकत नाही आणि त्या दोन्हींसाठी node कडे पुरेशी क्षमता नाही.
  • खालील local-path section मध्ये स्पष्ट केलेल्या कारणामुळे storage त्या मशीनशी जोडलेले राहते.
  • तुम्ही कोणतेही deployment केले नसले तरीही control plane सुमारे एक gigabyte RAM वापरतो.

यापैकी कोणतीही बाब k3s हा चुकीचा पर्याय ठरवत नाही. मात्र लोक नेहमी देतात त्या कारणासाठी, म्हणजे reliability साठी, तो चुकीचा पर्याय ठरतो. तुम्हाला प्रत्यक्षात अनेक machines हव्या असतील, जेणेकरून तुम्ही खरा multi-node cluster तयार करू शकाल, तर हा निर्णय आधी घ्या: तुमच्या स्वतःच्या hardware वरील Proxmox विरुद्ध rented VPS nodes कुठून मिळतील हे ठरवते; त्यानंतर k3s त्या nodes वर काय चालेल हे ठरवते.

तुम्ही काहीही deploy करण्यापूर्वी k3s साठी लागणारी RAM आणि CPU

k3s प्रकल्प अंदाजांऐवजी मोजलेली आकडेवारी प्रकाशित करतो. ती काळजीपूर्वक वाचा, कारण लोक सांगतात तो आकडा निष्क्रिय 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
  }
]

त्या चाचणीत server node ने 95th percentile वर 1,596 MB RAM आणि एका core पैकी सुमारे 6 टक्के CPU वापरले. हे प्रकाशित आकडे आहेत; या मार्गदर्शकातून घेतलेली मोजमापे नाहीत. या चाचणीत सर्व packaged components enabled असलेले k3s v1.26.5, तसेच Prometheus आणि Grafana monitoring stack चालू होते. त्यामुळे cluster रिकामा नसून व्यस्त होता. मात्र, हे आकडे फक्त Kubernetes datastore आणि control plane साठी आहेत आणि workload-specific requirements वगळतात, असे प्रकल्पाने नमूद केले आहे. तुमचे स्वतःचे containers याव्यतिरिक्त संसाधने वापरतात. sqlite ऐवजी embedded etcd वापरल्यावर RAM वापर 1,606 MB झाला. control plane नसलेला आणि kubelet व containerd चालवणारा agent node 275 MB RAM वापरत होता. server साठी documented 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 कार्यवाही करू शकतो. काही लहान services असलेल्या एका node साठी 4 GB हा आरामदायी किमान स्तर आहे. प्रकाशित कोणत्याही आकड्यावर, यामधील आकड्यावरही, अवलंबून राहण्याऐवजी तुमच्या स्वतःच्या मशीनवर मोजमाप करा.

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

install करण्यापूर्वी आणि kube-system मधील प्रत्येक pod Running स्थितीत आल्यानंतर पुन्हा free -h चालवा. या दोन मोजमापांमधील फरक म्हणजे तुमच्या hardware वर control plane साठी लागणारी संसाधने. install केल्यानंतर पहिल्या एक-दोन मिनिटांत k3s kubectl top node चे output error: Metrics API not available असते, कारण metrics-server ने अद्याप कोणतीही माहिती scrape केलेली नसते. ही त्रुटी नाही. तुम्ही या कामासाठी आणि इतर कामांसाठी एकाच वेळी एक मशीन वापरणार असाल, तर VPS साठी RAM आणि CPU चे sizing येथील गणित येथेही कोणताही बदल न करता लागू होते.

k3s हे latest ऐवजी विशिष्ट release वर pin करून install करा

सर्वजण कॉपी करत असलेली quick start ओळ तुम्ही ती चालवता त्या दिवशी stable channel ज्या release कडे निर्देश करतो तो release वापरते. ज्या मशीनचा दीर्घकाळ वापर करायचा आहे त्यावर release 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 लिहा आणि त्यानंतर install करा. k3s सुरू होताना /etc/rancher/k3s/config.yaml वाचते. त्यामुळे त्यातील प्रत्येक setting पहिल्या boot वेळी आणि त्यानंतरच्या प्रत्येक boot वेळी लागू होते.

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 ऐवजी एकच अचूक release pin करण्यासाठी INSTALL_K3S_VERSION=v1.36.5+k3s1 वापरा. plus चिन्ह tag चाच भाग आहे. त्यानंतर k3s सुरू झाले आहे का ते तपासा.

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

kubectl get node ने सुमारे तीस सेकंदांत STATUS Ready असलेला एक node दाखवायला हवा. kube-system मधील प्रत्येक pod Running किंवा Completed स्थितीत पोहोचायला हवा. एखादा node NotReady वर अडकला असल्यास container runtime सुरू झालेला नसण्याची शक्यता असते. त्यामुळे sudo journalctl -u k3s -n 100 --no-pager वाचा. VPS image असामान्य असल्यास, इतर कोणतेही debugging करण्यापूर्वी sudo k3s check-config चालवा. यात उपलब्ध नसलेली kernel features दाखवली जातात. Logs वाचण्यापेक्षा हे कारण अधिक जलद समजते.

पोर्ट 80 आधीच वापरात का आहे आणि ते दुरुस्त करण्यासाठी काय सोडावे

आधीपासून एखादी सेवा देत असलेल्या VPS वर ही अडचण अनेकांना येते. Install यशस्वी होते, पण एकमेव node वर दुसरा Kubernetes pod तोच hostPort आधीच राखून ठेवत असल्यास Traefik ला address मिळत नाही.

यामागील प्रक्रिया अशी आहे: समाविष्ट Traefik chart ports 80 आणि 443 वर LoadBalancer प्रकारची Service तयार करतो. ServiceLB या विनंतीला प्रतिसाद म्हणून लहान pods असलेला DaemonSet तयार करतो. या pods च्या नावाला svclb- prefix असतो. प्रत्येक node वर हे pods संबंधित port numbers hostPort म्हणून राखून ठेवतात. hostPort network rules द्वारे node port वरील traffic pod कडे पाठवतो. Scheduler Kubernetes pods ने घोषित केलेले host ports तपासतो; host services किंवा स्वतंत्र Docker containers ने धरलेले sockets तपासत नाही. दुसरा pod तोच hostPort राखून ठेवत असल्यास scheduling थांबते. मात्र port 80 वर nginx, Caddy, Apache किंवा स्वतंत्र 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 कडून conflicting hostPort reservation असल्यास 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 कोणती process त्या port वर ऐकत आहे ते दाखवते; scheduler तपासत असलेल्या hostPort reservations ते दाखवत नाही. यातून बाहेर पडण्याचे अनेक मार्ग आहेत आणि प्रत्येक मार्गाची काही किंमत आहे.

Ports k3s ला द्या. दुसऱ्या Kubernetes pod मधील conflicting hostPort reservation काढा. तसेच विद्यमान host web server थांबवून disable करा, जेणेकरून ports 80 आणि 443 वरील incoming traffic Traefik हाताळेल. VPS वर फक्त k3s चालवायचे असल्यास आणि तुम्ही देत असलेल्या सर्व सेवा Ingress मागे हलवणार असल्यास हा योग्य पर्याय आहे.

ServiceLB disable करा आणि विद्यमान proxy ठेवा. --disable=servicelb वापरून install करा. LoadBalancer प्रकारची Service तरीही NodePort allocate करते. त्यामुळे Traefik एखाद्या उच्च port वर, जसे 31480, उपलब्ध राहतो आणि तुमचा nginx किंवा Caddy 127.0.0.1:31480 कडे proxy करतो. या पर्यायात external address सोडावा लागतो: Service कायम <pending> दाखवते. हा दोष नसून तुम्ही केलेली निवड आहे, पण तसे न समजल्यास ते चुकीचे वाटू शकते.

Traefik disable करा आणि स्वतःच्या proxy द्वारे traffic route करा. --disable=traefik वापरून install करा. त्यानंतर तुमच्याकडे ingress controller राहणार नाही. त्यामुळे Ingress objects अजिबात कार्य करणार नाहीत: controller त्यांच्यावर लक्ष ठेवत नसल्याने ते API मध्ये तसेच राहतील. Host proxy कडून NodePorts कडे routing करणार असल्यास हा पर्याय योग्य आहे. HTTP कसे हाताळायचे हे तुम्हाला आधीच माहीत असल्यास ही स्पष्ट निवड आहे. कोणती सेवा पुढे ठेवायची याबद्दल निर्णय झाला नसेल, तर काहीही disable करण्यापूर्वी reverse proxy म्हणून nginx, Caddy आणि Traefik यांपैकी निवड ठरवा.

दोन्ही flags installer वर किंवा config file मध्ये द्यावेत:

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

Install नंतर ती file संपादित करून sudo systemctl restart k3s चालवले तरी कार्य करते. कारण --disable install वेळी एखादा component वगळण्यापुरते मर्यादित नाही. तो आधीच deploy केलेला component delete देखील करतो. त्यामुळे running cluster वरही हा बदल लागू होतो.

Traefik ठेवायचा असेल, पण chart configure करण्याची पद्धत बदलायची असेल, तर /var/lib/rancher/k3s/server/manifests/traefik.yaml संपादित करू नका. k3s प्रत्येक वेळी सुरू होताना ही file defaults ने पुन्हा लिहितो. त्याऐवजी त्याच directory मध्ये स्वतंत्र file जोडा. /var/lib/rancher/k3s/server/manifests मधील कोणतीही गोष्ट startup वेळी आणि disk वरील file बदलल्यावर आपोआप लागू होते.

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, सेट केली आहे. Ports सहित chart उपलब्ध करून देत असलेली इतर कोणतीही value याच पद्धतीने सेट करता येते.

एका नोडवरील Persistent storage

k3s मध्ये local-path नावाचा default StorageClass असतो. त्यामागे Rancher चा local-path provisioner असतो. storageClassName नसलेल्या PersistentVolumeClaim ला तो StorageClass मिळतो. Volumes /var/lib/rancher/k3s/storage मध्ये साठवले जातात. प्रत्येक volume साठी एक स्वतंत्र subdirectory असते आणि ती संबंधित node च्या स्वतःच्या disk वर असते.

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

“node च्या स्वतःच्या disk वर” याचे दोन परिणाम होतात. ते आज लगेच दिसत नाहीत, पण नंतर समस्या निर्माण करतात.

या StorageClass मध्ये volumeBindingMode: WaitForFirstConsumer वापरले जाते. त्यामुळे pod ने volume प्रत्यक्ष mount करेपर्यंत नवीन PVC Pending स्थितीत राहतो. kubectl describe pvc मध्ये हे दिसते:

waiting for first consumer to be created before binding

हे सामान्य आहे. त्यामुळे PVC स्वतंत्रपणे तयार करून वाट पाहिल्यास तो Pending स्थितीतून बाहेर येणार नाही.

Volume bind झाल्यावर, तो तयार करणाऱ्या node साठी त्याच्यावर node affinity लागू होते. त्यामुळे हा claim वापरणारा प्रत्येक pod volume अस्तित्वात असेपर्यंत त्याच node वर चालतो. फक्त एका node च्या cluster मध्ये हे लक्षात येणार नाही. नंतर दुसरा node जोडल्यावर, एखादा pod दुसऱ्या node वर हलण्यास नकार देऊ शकतो. kubectl get pv -o yaml चालवून nodeAffinity मध्ये hostname शोधेपर्यंत हे scheduler मधील bug असल्यासारखे दिसते.

Backups घेण्याची जबाबदारी तुमची आहे. VPS पुन्हा तयार केल्यास ती directory नष्ट होते. खालील uninstall script चालवल्यासही ती directory नष्ट होते. /var/lib/rancher/k3s/storage चा backup घ्या. तसेच service थांबवून copy केलेल्या sqlite datastore directory /var/lib/rancher/k3s/server/db/ चा backup घ्या, कारण ते live database आहे. याशिवाय /var/lib/rancher/k3s/server/token येथील server token file चा backup घ्या. हा token optional नाही. k3s च्या दस्तऐवजानुसार, backup मधून datastore restore करताना ती 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 वापरतात. तो त्याच्या प्रकाशित manifest मधून install करावा आणि एक ClusterIssuer तयार करावा. 23 October 2026 रोजी release झालेली v1.21.3 आवृत्ती October 2026 पर्यंतची current आवृत्ती आहे.

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 सार्वजनिक internet वरून http://hello.example.com/.well-known/acme-challenge/... शी connect होतो. त्यामुळे hostname चा DNS record, म्हणजे A record किंवा VPS IPv6 वरून reachable असल्यास AAAA record, आधीच VPS कडे निर्देश करत असला पाहिजे. तसेच port 80 वरून Traefik पर्यंत पोहोचता आले पाहिजे. A record आणि AAAA record दोन्ही असल्यास Let's Encrypt प्रथम IPv6 address वापरून पाहतो. सुरुवातीचे IPv6 connection timeout झाल्यास तो IPv4 कडे fallback करतो. चुकीचा challenge response यांसह इतर errors मुळे हा fallback होत नाही. Redirect केलेल्या requests साठीही retry होत नाही. जुना AAAA record दुरुस्त करा किंवा काढून टाका. ServiceLB disable करून स्वतःचा proxy पुढे ठेवला असल्यास, त्या proxy ने challenge path देखील forward केला पाहिजे. अन्यथा cert-manager Challenge object वर खालील संदेश दाखवून थांबतो:

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 वापरून issuance monitor करा.

kubeconfig आणि API server खाजगी का ठेवला जातो

k3s admin credentials /etc/rancher/k3s/k3s.yaml मध्ये लिहिते. ही फाइल root च्या मालकीची असते आणि default ने mode 600 सह लिहिली जाते. यात cluster-admin अधिकार असलेले client certificate असते. त्यामुळे ही फाइल वाचू शकणाऱ्या कोणत्याही व्यक्तीला संपूर्ण cluster वर अधिकार मिळतो.

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

स्वतंत्रपणे install केलेल्या kubectl ला k3s ची फाइल माहीत नसते. KUBECONFIG सेट नसल्यास ते ~/.kube/config वाचते. ही फाइल अस्तित्वात नसल्यास ते The connection to the server localhost:8080 was refused - did you specify the right host or port? सह अपयशी ठरते, कारण त्यात कोणताही cluster configured नसतो. KUBECONFIG सेट करा, खाली दाखवल्याप्रमाणे फाइल ~/.kube/config येथे copy करा, किंवा sudo k3s kubectl वापरा. ते योग्य फाइल स्वतः वाचते.

सामान्य user ने kubectl चालवता यावे यासाठी --write-kubeconfig-mode 644 सुचवलेले तुम्हाला दिसेल. त्याचा परिणाम समजून घ्या: यामुळे cluster-admin credential मशीनवरील प्रत्येक local account ला वाचता येते. Single-admin मशीनवर हा स्वीकारार्ह तडजोड असू शकते. Shared मशीनवर तसे नाही. फाइल copy केल्यास ती सार्वजनिक न करता एका user ला access देता येतो:

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

त्या फाइलमधील server: line https://127.0.0.1:6443 वाचते. Laptop वरून kubectl वापरण्यासाठी 6443 पोर्ट internet साठी उघडू नका. Public Kubernetes API हे सतत हल्ल्याचे लक्ष्य असते. उघड्या API मुळे लहान clusters दुसऱ्यांसाठी cryptocurrency mining करण्यासाठी वापरले जाऊ शकतात. ते SSH द्वारे tunnel करा आणि फाइलमधील address तसाच ठेवा:

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

Private network address द्वारे API पर्यंत पोहोचणे आवश्यक असल्यास, त्या name किंवा address ची नोंद tls-san मध्ये करून install करा. त्यानंतर copy केलेल्या फाइलमधील 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 साठी documented inbound ports हे API साठी TCP 6443, nodes मधील flannel VXLAN साठी UDP 8472 आणि kubelet metrics साठी TCP 10250 आहेत. Single-node cluster वर यांपैकी एकही port internet साठी उघडा ठेवण्याची गरज नाही.

containerd हे Docker नाही

k3s स्वतःचे embedded containerd चालवते. ते Docker सोबत image store share करत नाही. तुम्ही नुकतीच docker build वापरून build केलेली image k3s ला दिसत नाही. त्यामुळे docker images ती image दाखवत असले तरी pod ErrImagePull सह अयशस्वी होतो. ती image स्पष्टपणे import करा:

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

त्यानंतर त्या container वर :latest tag वापरू नका. कारण :latest मध्ये default म्हणून imagePullPolicy चे Always असते आणि kubelet तरीही registry शी संपर्क करतो. इतर कोणत्याही tag साठी default IfNotPresent असते. त्यामुळे तुम्ही import केलेली image वापरली जाते. एकाच VPS वर दोन्ही चालवता येतात. तसेच हे लक्षात ठेवा की VPS वरील सामान्य Docker install आणि k3s एकाच मशीनवर स्वतःचे स्वतंत्र image store आणि स्वतंत्र iptables rules ठेवतात.

k3s कसे काढावे

Installer एक uninstall script लिहितो. अंशतः काढण्याची किंवा पूर्ववत करण्याची सुविधा नाही.

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

हे script service थांबवते आणि काढते, datastore हटवते, persistent volume data हटवते, node configuration काढते आणि installer ने जोडलेली tools काढते. Agent node वर script त्याऐवजी k3s-agent-uninstall.sh असते. /var/lib/rancher/k3s/storage अंतर्गत असलेली कोणतीही सामग्री आधी box मधून बाहेर copy करा, कारण ही directory देखील काढली जाते. त्यानंतर ip link show आणि sudo ss -lntp वापरून कोणतीही प्रक्रिया ports किंवा interfaces धरून ठेवत नाही याची तपासणी करा. उरलेले cni0 किंवा flannel.1 interface पुढील reboot वेळी आपोआप काढले जाते.

Kubernetes मधील एका node साठी हे कामाच्या गरजेपेक्षा अधिक यंत्रणा आहे असे ठरवणे हा अपयश नसून सामान्य परिणाम आहे. हे workloads पुन्हा Compose वर हलवणे सहसा एका दुपारचे काम असते.

अपयशाच्या प्रकारांमध्ये दिसणारे संदेश

Node NotReady किंवा k3s सतत restart होत आहे. प्रथम sudo journalctl -u k3s -n 200 --no-pager वाचा. लहान VPS वर सामान्य कारण म्हणजे kernel चा out-of-memory killer प्रक्रिया बंद करतो. dmesg मध्ये k3s-server चे नाव असलेली ओळ दिसते. दस्तऐवजीकरणातील 2 GB ची किमान आवश्यकता ही प्रत्यक्ष किमान मर्यादा आहे.

Pod Pending स्थितीत अडकलेला आहे. kubectl describe pod प्रत्येक वेळी कारण सांगते. Insufficient memory किंवा Insufficient cpu याचा अर्थ node वर जागा शिल्लक नाही. didn't have free ports याचा अर्थ दुसरा Kubernetes pod विरोधाभासी hostPort आरक्षित करत आहे. PVC वरील waiting for first consumer म्हणजे WaitForFirstConsumer अपेक्षेप्रमाणे काम करत आहे.

ImagePullBackOff. Node ला image pull करता आली नाही. Image चे नाव आणि tag, registry access आणि credentials तपासा. तसेच Docker वापरून image build केली असून ती containerd मध्ये import केली नाही का, हे तपासा.

Traefik प्रतिसाद देतो, पण app देत नाही. 404 page not found असलेला response body स्वतः Traefik कडून येतो. याचा अर्थ request पोहोचली, पण कोणत्याही router शी जुळली नाही. Ingress मधील host तुम्ही टाइप केलेल्या नावाशी जुळते का, आणि ingressClassName हे traefik आहे का, ते तपासा.

Host नाव resolve करतो, पण cluster DNS अयशस्वी होते. sudo k3s kubectl -n kube-system logs -l k8s-app=kube-dns वापरून CoreDNS तपासा. plugin/loop: Loop ... detected for zone "." सारखा संदेश CoreDNS सुरू होण्यापासून थांबवतो. CoreDNS अशा resolver कडे forwarding करत आहे, जो पुन्हा त्याच्याकडेच forward करतो. /etc/resolv.conf मधील loopback address मुळे असे घडते. --resolv-conf /run/systemd/resolve/resolv.conf वापरून k3s ला वास्तविक upstream file कडे निर्देशित करा.

FAQ

एकाच VPS वर k3s चालवणे योग्य आहे का?

तुम्हाला Kubernetes API आवश्यक असेल, तर ते योग्य आहे: तुम्ही स्वतः नियंत्रित करत असलेल्या मशीनवर त्याचे शिक्षण घेऊ शकता, deployments manifests म्हणून portable ठेवू शकता, केवळ Helm chart प्रकाशित करणारे software चालवू शकता किंवा पुढे managed cluster वर हलवायची व्यवस्था तयार करू शकता. तुम्हाला फक्त containers चालवायचे असतील, तर ते योग्य नाही, कारण Docker Compose हे काम देखभालीसाठी खूपच कमी प्रयत्नांत आणि साधारण एक gigabyte अधिक मोकळ्या RAM सह करते. एका node मुळे high availability मिळत नाही. त्यामुळे reliability हे ते निवडण्याचे कारण असू शकत नाही.

माझी k3s LoadBalancer service Pending का राहते?

ServiceLB svclb- pods तयार करते. हे pods node वर service चे ports hostPort म्हणून reserve करतात. त्यामुळे ते ports मोकळे असलेल्या node वरच schedule होतात. दुसरा Kubernetes pod तोच hostPort आधीच reserve करत असल्यास pod Pending राहतो आणि service ला external address मिळत नाही. Port 80 वर ऐकणारा 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 करा आणि service ने अद्याप allocate केलेल्या NodePort कडे proxy करा.

VPS वर k3s ला किती RAM आवश्यक आहे?

Server node साठी दस्तऐवजीकृत किमान आवश्यकता 2 cores आणि 2 GB आहे. तुमचे workloads चालवण्यापूर्वी ही क्षमता k3s आणि त्याच्या packaged components साठी पुरेशी असते. Project च्या profiling नुसार monitoring stack चालू असताना server node च्या control plane आणि datastore ने 1,596 MB वापरले. या आकड्यात workload ची स्वतःची memory समाविष्ट नाही. त्यामुळे 2 GB ही किमान मर्यादा समजा आणि एका node साठी 4 GB ही आरामदायी सुरुवातीची क्षमता समजा. Install करण्यापूर्वी आणि kube-system मधील प्रत्येक pod Running झाल्यानंतर पुन्हा free -h वापरून तुमच्या मशीनवरील memory मोजा.

मी एकाच VPS वर Docker आणि k3s चालवू शकतो का?

होय. दोन्ही स्वतंत्र राहतात. k3s स्वतःचे embedded containerd वापरते. त्यामुळे docker build ने तयार केलेली image docker save myapp:0.1 | sudo k3s ctr images import - चालवेपर्यंत k3s ला दिसत नाही. दोन्ही स्वतःचे iptables rules आणि स्वतःचे bridge networks लिहितात. Memory ची एकूण उपलब्धता तपासा, कारण Docker, k3s आणि तुमचे containers हे सर्व त्याच मशीनची 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 आधी मशीनबाहेर copy करा, कारण ही कृती पूर्ववत करता येत नाही. उरलेला cni0 किंवा flannel.1 network interface पुढील reboot वेळी नाहीसा होतो.

हा लेख उपयुक्त होता का?

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