SSD Nodes Learn Hosting plans →

VPS-ல் Single-node k3s பயன்படுத்துவது நல்லதா?

VPS-ல் k3s நிறுவும் போது ஏற்படும் RAM பயன்பாடு மற்றும் port 80 மோதல்களைப் பற்றி அறியுங்கள். Docker Compose-க்கு பதிலாக எப்போது k3s-ஐ தேர்வு செய்வது என்பது குறித்த முழுமையான அலசல்.

k3s என்றால் என்ன, அதன் ஒரு node உங்களுக்கு என்ன வழங்குகிறது

k3s என்பது ஒரே binary-ஆக தொகுக்கப்பட்ட முழுமையான Kubernetes distribution ஆகும். இதை ஒரு single VPS-ல் இயக்கும்போது, மூன்று machine-களைக் கொண்ட control plane இல்லாமலேயே உங்களுக்கு உண்மையான Kubernetes API கிடைக்கிறது. இது ஒரு certified Kubernetes distribution என்பதால், இதில் பயன்படுத்தும் manifest-ஐ பிற்காலத்தில் ஒரு managed cluster-லும் பயன்படுத்தலாம். இதன் நிறுவல் ஒரே ஒரு command மூலம், சுமார் ஒரு நிமிடத்தில் முடிந்துவிடும். இதற்கு நீங்கள் கொடுக்கும் விலை, உங்கள் applications-க்கு கிடைக்காத memory மற்றும் Docker Compose-ல் ஏற்படாத சில failure modes ஆகும்.

SUSE நிறுவனம் edge sites மற்றும் சிறிய installations-க்காக k3s-ஐ உருவாக்குகிறது. upstream Kubernetes-லிருந்து இது மாறுபடுவதற்கு காரணம், இதை சிறியதாகவும் எளிமையாகவும் இயக்குவதே ஆகும். இதன் default datastore, etcd-க்கு பதிலாக kine எனப்படும் shim மூலம் இயங்கும் sqlite ஆகும்; எனவே இதில் etcd quorum-ஐ பராமரிக்க வேண்டிய அவசியமில்லை. containerd தனியாக நிறுவப்படாமல், இந்த binary-க்குள்ளேயே இணைக்கப்பட்டுள்ளது. அதே binary-ல் cluster DNS-க்காக CoreDNS, ingress controller-ஆக Traefik, cloud provider இல்லாமலேயே LoadBalancer services வேலை செய்ய ServiceLB (இது klipper-lb என்றும் அழைக்கப்படுகிறது), persistent volumes-க்காக local-path provisioner, metrics-server மற்றும் pod networking-க்காக flannel ஆகியவையும் வழங்கப்படுகின்றன. இவை அனைத்தும் default-ஆகவே தொடங்கும். இந்த default அமைப்புகள் Traefik-ஐ 80 மற்றும் 443 ports-ல் வைக்கும். எனவே, ஏற்கனவே ஏதேனும் சேவைகளை வழங்கி வரும் ஒரு VPS-ல் இதை நிறுவும் முன், அந்த ports-ஐ யார் பயன்படுத்துவது என்பதை முடிவு செய்யுங்கள்.

ஒரே k3s node எப்போது பயனுள்ளது

Kubernetes API உங்களுக்குத் தேவைப்படும்போது k3s-ஐப் பயன்படுத்துங்கள்: நீங்கள் உங்கள் கட்டுப்பாட்டில் உள்ள ஒரு கணினியில் Kubernetes-ஐக் கற்கிறீர்கள் அல்லது உங்களுக்குத் தேவையான மென்பொருள் Helm chart வடிவில் மட்டுமே கிடைக்கிறது. Manifest-களின் இடமாற்றத்திறனும் (portability) முக்கியமானது, ஏனெனில் நீங்கள் இங்கே எழுதும் Deployment-ஐ மாற்றமின்றி ஒரு managed cluster-க்குக் கொண்டு செல்ல முடியும். உங்களுக்குத் தேவையானவை applications மட்டுமே என்றால் Docker Compose-ஐப் பயன்படுத்துங்கள். Compose அதே containers-ஐ மிகக் குறைவான பாகங்களுடன் தொடங்குகிறது, மேலும் ஒரு VPS-ல் உள்ள Compose file-ஐ ஒரு வருடம் கழித்துப் பார்த்தாலும், manifest-கள் நிறைந்த கோப்புறையை விட எளிதாகப் புரிந்துகொள்ள முடியும்.

ஒரே node-ல் என்ன கிடைக்காது என்பதைத் தெளிவாகப் புரிந்துகொள்ளுங்கள்.

  • High availability கிடையாது. VPS reboot ஆகும்போது, அனைத்து workload-களும் நின்றுவிடும். Kubernetes ஒரு pod-ஐ மற்றொரு node-க்கு மாற்ற முயற்சிக்கும், ஆனால் அங்கே வேறு node இருக்காது.
  • ஒரு service-ஐத் தொடர்ந்து இயங்க வைக்கும் rolling update வசதி கிடையாது, அந்த application ஒரே கணினியில் இரண்டு replicas-ஐத் தாங்கிக்கொள்ளும் திறன் பெற்று, node-ல் அதற்கான இடவசதி இருந்தால் ஒழிய.
  • கீழே உள்ள local-path பகுதியில் விவரிக்கப்பட்டுள்ள காரணத்திற்காக, அந்த கணினியுடன் பிணைக்கப்பட்ட (pinned) சேமிப்பகம் மட்டுமே இருக்கும்.
  • நீங்கள் எதையும் deploy செய்யாவிட்டாலும், control plane-க்கு சுமார் ஒரு gigabyte RAM தேவைப்படும்.

இவை எவையும் k3s-ஐ ஒரு மோசமான தேர்வாக மாற்றிவிடாது. மக்கள் பொதுவாகக் கூறும் காரணத்திற்காக, அதாவது நம்பகத்தன்மைக்காக (reliability) இது ஒரு மோசமான தேர்வாகிறது. உங்களுக்கு உண்மையில் பல கணினிகள் தேவைப்பட்டு, அதன் மூலம் ஒரு உண்மையான multi-node cluster-ஐ உருவாக்க விரும்பினால், அந்த முடிவே முதலில் வர வேண்டும்: சொந்த வன்பொருளில் Proxmox அல்லது வாடகை VPS என்பது, k3s எதை இயக்குகிறது என்பதைத் தீர்மானிக்கும் முன்பே, node-கள் எங்கிருந்து வருகின்றன என்பதைத் தீர்மானிக்கிறது.

எந்தவொரு பயன்பாட்டையும் நிறுவும் முன் k3s-க்குத் தேவைப்படும் RAM மற்றும் CPU அளவு

k3s திட்டம் மதிப்பீடுகளை விட அளவிடப்பட்ட புள்ளிவிவரங்களையே வெளியிடுகிறது. அவற்றை கவனமாகப் படிக்கவும், ஏனெனில் மக்கள் குறிப்பிடும் எண்ணிக்கை k3s-ன் idle நிலையைக் குறிப்பதல்ல.

விளக்கப்படம்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, 95-வது percentile அளவில் 1,596 MB RAM-ஐயும், ஒரு core-ன் சுமார் 6 சதவீதத்தையும் பயன்படுத்தியது. இவை வெளியிடப்பட்ட புள்ளிவிவரங்கள், இந்த வழிகாட்டியில் எடுக்கப்பட்ட அளவீடுகள் அல்ல. இந்தச் சோதனையானது k3s v1.26.5 பதிப்பில், அனைத்து தொகுக்கப்பட்ட கூறுகளும் (packaged components) மற்றும் Prometheus, Grafana monitoring stack ஆகியவற்றுடன் இயங்கியது. எனவே cluster காலியாக இல்லாமல் பயன்பாட்டில் இருந்தது. இருப்பினும், இந்த புள்ளிவிவரங்கள் Kubernetes datastore மற்றும் control plane-க்கு மட்டுமே பொருந்தும் என்றும், workload-க்கான தேவைகளை உள்ளடக்கியதல்ல என்றும் அந்தத் திட்டம் குறிப்பிடுகிறது. உங்கள் containers-க்கான தேவை இதற்கு மேலதிகமானது. sqlite-க்கு பதிலாக embedded etcd-ஐப் பயன்படுத்தும்போது இது 1,606 MB ஆக உயர்ந்தது. control plane இல்லாமல் kubelet மற்றும் containerd மட்டும் இயங்கும் ஒரு agent node, 275 MB-ஐப் பயன்படுத்தியது. ஒரு server-க்கான குறைந்தபட்சத் தேவை 2 cores மற்றும் 2 GB RAM என ஆவணப்படுத்தப்பட்டுள்ளது. இந்த குறைந்தபட்ச அளவு, உங்கள் workload-களைத் தொடங்கும் முன் k3s மற்றும் அதன் தொகுக்கப்பட்ட கூறுகளுக்கு மட்டுமே பொருந்தும்.

நடைமுறை விளக்கம்: 2 GB VPS-ல் control plane மற்றும் அதன் bundled add-ons-ஐ இயக்கிய பிறகு, உங்களுக்கு மிகக் குறைந்த அளவே மீதமிருக்கும். Memory அழுத்தம் ஏற்படும்போது kubelet pods-ஐ வெளியேற்றும் (evict), ஆனால் memory பயன்பாடு மிக வேகமாக உயர்ந்தால், kubelet அழுத்தம் ஏற்படுவதைக் கண்டறிவதற்கு முன்பே kernel-ன் OOM killer செயல்படக்கூடும். சில சிறிய சேவைகளைக் கொண்ட ஒரு node-க்கு 4 GB என்பது ஒரு வசதியான குறைந்தபட்ச அளவாகும். இதில் உள்ள புள்ளிவிவரங்கள் உட்பட, வெளியிடப்பட்ட எதையும் அப்படியே நம்பாமல், உங்கள் சொந்த server-ல் அளவீடு செய்யவும்.

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

நீங்கள் நிறுவுவதற்கு முன்பும், kube-system-ல் உள்ள அனைத்து pods-ம் Running நிலைக்கு வந்த பிறகும் free -h-ஐ இயக்கவும். இந்த இரண்டுக்கும் உள்ள வித்தியாசமே உங்கள் hardware-ல் control plane-க்கு ஆகும் செலவாகும். நிறுவிய முதல் ஒன்று அல்லது இரண்டு நிமிடங்களுக்கு k3s kubectl top node, error: Metrics API not available-ஐத் திருப்பி அனுப்பும், ஏனெனில் metrics-server இன்னும் எதையும் ஸ்கேன் செய்திருக்காது. இது ஒரு பிழை அல்ல. இதற்கும் பிற பணிகளுக்கும் ஒரே server-ஐப் பயன்படுத்தத் திட்டமிட்டால், VPS-க்கான RAM மற்றும் CPU-ஐத் தீர்மானித்தல் பகுதியில் உள்ள கணக்கீடுகள் இதற்கும் அப்படியே பொருந்தும்.

k3s-ஐ சமீபத்திய பதிப்பிற்குப் பதிலாக, ஒரு குறிப்பிட்ட release-ல் நிறுவுதல்

எல்லோரும் நகலெடுக்கும் quick start கட்டளை, நீங்கள் அதை இயக்கும் நாளில் stable channel எதைக் குறிக்கிறதோ அதையே நிறுவுகிறது. நீங்கள் தொடர்ந்து பயன்படுத்தப்போகும் ஒரு கணினியில், பதிப்பை முன்கூட்டியே தீர்மானித்து (pin) நிறுவுவது சிறந்தது. k3s ஒவ்வொரு Kubernetes minor பதிப்பிற்கும் ஒரு channel-ஐ வெளியிடுகிறது, எனவே INSTALL_K3S_CHANNEL=v1.36 என்பது v1.36-க்குள் வரும் patch வெளியீடுகளை மட்டுமே பின்பற்றும், தானாகவே அடுத்த minor பதிப்பிற்கு மாறாது. அக்டோபர் 2026 நிலவரப்படி, stable channel ஆனது v1.36.5+k3s1-ஐக் குறிக்கிறது.

முதலில் configuration கோப்பை உருவாக்கிவிட்டு, பிறகு நிறுவுதலைத் தொடங்கவும். k3s தொடங்கும்போதே /etc/rancher/k3s/config.yaml கோப்பைப் படிக்கும், எனவே அதில் உள்ளவை முதல் 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-ஐ மட்டும் பயன்படுத்த, INSTALL_K3S_VERSION=v1.36.5+k3s1-ஐப் பயன்படுத்தவும். பிளஸ் (+) குறியீடு அந்த tag-ன் ஒரு பகுதியாகும். அதன் பிறகு, அது சரியாக இயங்குகிறதா என்று சரிபார்க்கவும்.

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

kubectl get node கட்டளையை இயக்கினால், சுமார் முப்பது வினாடிகளுக்குள் Ready நிலையுடன் ஒரு node பட்டியலிடப்பட வேண்டும், மேலும் kube-system-ல் உள்ள அனைத்து pod-களும் Running அல்லது Completed நிலையை அடைய வேண்டும். ஒரு node NotReady நிலையிலேயே இருந்தால், அது பெரும்பாலும் container runtime தொடங்கவில்லை என்பதைக் குறிக்கும்; எனவே sudo journalctl -u k3s -n 100 --no-pager-ஐப் படித்துப் பார்க்கவும். வழக்கத்திற்கு மாறான VPS image-ஐப் பயன்படுத்துகிறீர்கள் என்றால், மற்ற எதையும் debug செய்வதற்கு முன் sudo k3s check-config-ஐ இயக்கவும்: இது விடுபட்ட kernel அம்சங்களைப் பட்டியலிடும், இது logs-ஐப் படிப்பதைக் காட்டிலும் விரைவான தீர்வைத் தரும்.

port 80 ஏன் ஏற்கனவே பயன்பாட்டில் உள்ளது மற்றும் அதைச் சரிசெய்ய எதை விட்டுக்கொடுக்க வேண்டும்

ஏற்கனவே ஏதோ ஒரு சேவையை வழங்கி வரும் VPS-ல் இதுவே பயனர்களைப் பாதிக்கும் தோல்வியாகும். நிறுவல் வெற்றிகரமாக முடிந்துவிடும், ஆனால் மற்றொரு Kubernetes pod ஏற்கனவே ஒரே node-ல் அதே hostPort-ஐ முன்பதிவு செய்திருந்தால், Traefik-க்கு முகவரி கிடைக்காது.

இதன் செயல்முறை: தொகுக்கப்பட்ட Traefik chart, ports 80 மற்றும் 443-ல் LoadBalancer வகை Service-ஐ உருவாக்குகிறது. ServiceLB அந்த கோரிக்கைக்குப் பதிலளிக்கும் விதமாக, svclb- முன்னொட்டுடன் கூடிய சிறிய pods-ன் DaemonSet-ஐ உருவாக்கி, ஒவ்வொரு node-லும் அந்த port எண்களை hostPort-ஆகக் கோருகிறது. hostPort, network விதிகள் மூலம் node port-லிருந்து pod-க்கு traffic-ஐ அனுப்புகிறது. Kubernetes pods அறிவிக்கும் host ports-ஐ மட்டுமே scheduler சரிபார்க்கிறது; host services அல்லது standalone Docker containers வைத்திருக்கும் sockets-ஐ அல்ல. அதே hostPort-ஐ முன்பதிவு செய்யும் மற்றொரு pod, scheduling-ஐத் தடுக்கும்; port 80-ல் இயங்கும் nginx, Caddy, Apache அல்லது standalone Docker container நேரடியாக அந்த scheduling நிராகரிப்பை ஏற்படுத்தாது.

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 முன்பதிவு இருந்தால், svclb pod 'Pending' நிலையிலும், service-க்கு external முகவரி இல்லாமலும் இருப்பதைக் காண்பீர்கள்:

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-ல் கேட்கிறது (listen) என்பதைக் காட்டும்; ஆனால் scheduler சரிபார்க்கும் hostPort முன்பதிவுகளை அது காட்டாது. இதிலிருந்து வெளியேற ஒன்றுக்கும் மேற்பட்ட வழிகள் உள்ளன, ஒவ்வொன்றிற்கும் ஒரு விலை உண்டு.

ports-ஐ k3s-க்கு வழங்கவும். மற்றொரு Kubernetes pod-லிருந்து முரண்படும் hostPort முன்பதிவை நீக்கிவிட்டு, ஏற்கனவே உள்ள host web server-ஐ நிறுத்தி, disable செய்யவும். அப்போதுதான் Traefik 80 மற்றும் 443-ல் வரும் traffic-ஐக் கையாளும். VPS ஒரு k3s box-ஆக மட்டுமே இருக்கும்போது இதுவே சரியான தீர்வாகும், மேலும் நீங்கள் வழங்கிய அனைத்தும் Ingress-க்கு பின்னால் நகர்த்தப்படும்.

ServiceLB-ஐ முடக்கிவிட்டு, ஏற்கனவே உள்ள proxy-ஐத் தக்கவைக்கவும். --disable=servicelb கொண்டு நிறுவவும். LoadBalancer வகை Service இன்னும் ஒரு NodePort-ஐ ஒதுக்கும், எனவே Traefik 31480 போன்ற ஒரு high port-ல் அணுகக்கூடியதாக இருக்கும், மேலும் உங்கள் nginx அல்லது Caddy 127.0.0.1:31480-க்கு proxy செய்யும். நீங்கள் விட்டுக்கொடுப்பது external முகவரிதான்: service எப்போதும் <pending> என்று காட்டும், இது நீங்கள் எடுத்த முடிவாக இருக்கும்போது பிழையாகத் தோன்றும்.

Traefik-ஐ முடக்கிவிட்டு, உங்கள் சொந்த proxy மூலம் route செய்யவும். --disable=traefik கொண்டு நிறுவவும். அப்போது உங்களிடம் ingress controller இருக்காது, எனவே Ingress objects எதையும் செய்யாது: அவை எந்த controller-ம் கவனிக்காத நிலையில் API-ல் இருக்கும். host proxy-லிருந்து NodePorts-க்கு route செய்யும்போது இது சரியாக இருக்கும், மேலும் HTTP எவ்வாறு கையாளப்பட வேண்டும் என்பது உங்களுக்கு ஏற்கனவே தெரிந்திருந்தால் இதுவே நேர்மையான தேர்வாகும். எதை முன்னால் வைப்பது என்பதில் உங்களுக்குத் தெளிவு இல்லையென்றால், எதையாவது முடக்கும் முன் nginx, Caddy மற்றும் Traefik ஆகியவற்றுக்கு இடையேயான reverse proxy தேர்வை முடிவு செய்யவும்.

இரண்டு flags-ம் installer-ல் அல்லது config கோப்பில் இருக்க வேண்டும்:

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

நிறுவிய பின் அந்தக் கோப்பைத் திருத்தி sudo systemctl restart k3s-ஐ இயக்குவதும் வேலை செய்யும், ஏனெனில் --disable நிறுவலின் போது ஒரு component-ஐத் தவிர்ப்பதை விட அதிகமாகச் செய்கிறது. இது ஏற்கனவே deployed செய்யப்பட்ட ஒரு component-ஐ நீக்குகிறது, எனவே அந்த மாற்றம் இயங்கும் cluster-ல் அமலுக்கு வரும்.

Traefik-ஐத் தக்கவைத்துக்கொண்டு, chart எவ்வாறு கட்டமைக்கப்பட்டுள்ளது என்பதை மாற்ற, /var/lib/rancher/k3s/server/manifests/traefik.yaml-ஐத் திருத்த வேண்டாம். k3s ஒவ்வொரு முறை தொடங்கும்போதும் அந்தக் கோப்பை default மதிப்புகளுடன் மீண்டும் எழுதும். அதற்குப் பதிலாக அதே directory-ல் ஒரு தனி கோப்பைச் சேர்க்கவும், ஏனெனில் /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 chart மதிப்பை, அதாவது trusted proxy முகவரிகளை அமைக்கிறது. அதே செயல்முறை, அதன் ports உட்பட chart வெளிப்படுத்தும் வேறு எந்த மதிப்பையும் அமைக்கும்.

ஒரு node-ல் நிலையான சேமிப்பகம் (Persistent storage)

k3s, local-path என்ற பெயரில் ஒரு இயல்புநிலை StorageClass-ஐ வழங்குகிறது. இது Rancher-ன் local-path provisioner மூலம் இயங்குகிறது. storageClassName குறிப்பிடப்படாத எந்தவொரு PersistentVolumeClaim-ம் இதையே பயன்படுத்தும். Volumes அனைத்தும் node-ன் சொந்த வட்டில், ஒவ்வொரு volume-க்கும் ஒரு subdirectory வீதம் /var/lib/rancher/k3s/storage-ல் சேமிக்கப்படும்.

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

"Node-ன் சொந்த வட்டில்" சேமிக்கப்படுவதால் இரண்டு விளைவுகள் ஏற்படுகின்றன. இவை தற்போது தெரியாவிட்டாலும், பிற்காலத்தில் சிக்கலை உண்டாக்கும்.

இந்த StorageClass volumeBindingMode: WaitForFirstConsumer-ஐப் பயன்படுத்துவதால், ஒரு pod அதை mount செய்யும் வரை புதிய PVC ஆனது Pending நிலையிலேயே இருக்கும். kubectl describe pvc கட்டளையை இயக்கினால் இதைக் காணலாம்:

waiting for first consumer to be created before binding

இது சாதாரணமான ஒன்றுதான். எனவே, PVC-ஐ மட்டும் உருவாக்கிவிட்டு அது தானாக மாறும் என்று காத்திருந்தால், அது மாறாது.

ஒருமுறை bound ஆன பிறகு, அந்த volume-ஐ உருவாக்கிய node-க்கு ஒரு affinity உருவாகிவிடும். இதனால் அந்த claim-ஐப் பயன்படுத்தும் ஒவ்வொரு pod-ம், அந்த volume இருக்கும் காலம் வரை அதே node-ல் பிணைக்கப்படும். ஒரே ஒரு node இருக்கும்போது இது தெரியாது. பிற்காலத்தில் இரண்டாவது node-ஐச் சேர்க்கும்போது, pod நகர மறுப்பது ஒரு scheduler பிழை போலத் தோன்றும். ஆனால் kubectl get pv -o yaml கட்டளையை இயக்கி, nodeAffinity-ல் உள்ள hostname-ஐப் பார்த்தால் உண்மை புரியும்.

Backups எடுப்பது உங்கள் பொறுப்பு. VPS-ஐ மீண்டும் கட்டமைத்தால் அந்த directory அழிந்துவிடும், கீழே உள்ள uninstall script-ஐ இயக்கினாலும் அதுவே நடக்கும். /var/lib/rancher/k3s/storage-ஐ backup எடுக்கவும். அத்துடன், service-ஐ நிறுத்திய பிறகு /var/lib/rancher/k3s/server/db/-ல் உள்ள sqlite datastore directory-ஐயும் நகலெடுக்கவும் (ஏனெனில் அது ஒரு live database). மேலும், /var/lib/rancher/k3s/server/token-ல் உள்ள server token கோப்பையும் backup எடுக்கவும். இந்த token கட்டாயமானது: datastore-ஐ backup-லிருந்து மீட்டெடுக்கும்போது, இந்தக் கோப்பை மீண்டும் வைக்க வேண்டும் அல்லது அதன் மதிப்பை --token-க்கு வழங்க வேண்டும் என்று k3s ஆவணங்கள் கூறுகின்றன. இதற்கு மாற்றாக, cluster-ஐத் தற்காலிகமானதாகக் கருதி, ஒவ்வொரு manifest-ஐயும் git-ல் சேமித்து வைப்பதே சிறந்த வழி.

Ingress மற்றும் TLS

Traefik enabled நிலையில் இருக்கும்போது, ஒரு 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 மூலம் நிறுவப்பட வேண்டும், அதனுடன் ஒரு ClusterIssuer-ம் தேவை. அக்டோபர் 2026 நிலவரப்படி, 23 அக்டோபர் 2026 அன்று வெளியிடப்பட்ட v1.21.3 பதிப்பு தற்போதைய பதிப்பாகும்.

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 பொது இணையத்திலிருந்து http://hello.example.com/.well-known/acme-challenge/...-ஐத் தொடர்பு கொள்வதைக் குறிக்கிறது. எனவே, hostname-ன் DNS record (VPS IPv6 வழியாக அணுகக்கூடியதாக இருந்தால், A record அல்லது AAAA record) ஏற்கனவே அந்த VPS-ஐச் சுட்டிக்காட்ட வேண்டும், மேலும் port 80 Traefik-ஐ அடைய வேண்டும். IPv6 மற்றும் IPv4 ஆகிய இரண்டும் இருக்கும்போது, Let’s Encrypt முதலில் IPv6 முகவரியை முயற்சிக்கும்; ஆனால் ஆரம்ப IPv6 இணைப்பு காலாவதியானால் (timeout) அது IPv4-க்கு மாறிவிடும். தவறான challenge response உள்ளிட்ட பிற பிழைகள் இந்த மாற்றத்தைத் தூண்டாது, மேலும் redirected கோரிக்கைகளுக்கு மறுமுயற்சி (retry) செய்யப்படாது. பழைய AAAA record-ஐச் சரிசெய்யவும் அல்லது நீக்கவும். நீங்கள் ServiceLB-ஐ முடக்கிவிட்டு, உங்கள் சொந்த proxy-ஐ முன்னால் வைத்திருந்தால், அந்த proxy-யும் challenge path-ஐ forward செய்ய வேண்டும்; இல்லையெனில், Challenge object-ல் cert-manager பின்வருமாறு நின்றுவிடும்:

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 செயல்பாட்டைக் கண்காணிக்கவும்.

kubeconfig மற்றும் API server ஏன் தனிப்பட்ட முறையில் (private) வைக்கப்படுகிறது

k3s நிர்வாகி சான்றுகளை (admin credentials) /etc/rancher/k3s/k3s.yaml-ல் எழுதுகிறது. இந்த கோப்பு root பயனருக்குச் சொந்தமானது மற்றும் இயல்பாக 600 என்ற முறையில் (mode) எழுதப்படுகிறது. இதில் cluster-admin உரிமைகளைக் கொண்ட client certificate இருப்பதால், இதைப் படிக்கக்கூடிய எவரும் முழு cluster-ஐயும் கட்டுப்படுத்த முடியும்.

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

தனித்தனியாக நிறுவப்பட்ட kubectl-க்கு k3s கோப்பைப் பற்றித் தெரியாது. KUBECONFIG அமைக்கப்படாத நிலையில், அது ~/.kube/config-ஐப் படிக்க முயலும். அக்கோப்பு இல்லையென்றால், எந்த cluster-ம் கட்டமைக்கப்படவில்லை என்ற பிழையுடன் The connection to the server localhost:8080 was refused - did you specify the right host or port? தோல்வியடையும். KUBECONFIG-ஐ அமைக்கவும், கீழே காட்டப்பட்டுள்ளபடி கோப்பை ~/.kube/config-க்கு நகலெடுக்கவும், அல்லது sudo k3s kubectl-ஐப் பயன்படுத்தவும்; இது சரியான கோப்பைத் தானாகவே கண்டறியும்.

ஒரு சாதாரண பயனர் kubectl-ஐ இயக்க --write-kubeconfig-mode 644 பரிந்துரைக்கப்படுவதைக் காண்பீர்கள். அது என்ன செய்கிறது என்பதைப் புரிந்துகொள்ளுங்கள்: இது கணினியில் உள்ள அனைத்து உள்ளூர் கணக்குகளும் படிக்கக்கூடிய வகையில் 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 port-ஐ இணையத்திற்குத் திறந்து வைக்காதீர்கள். பொதுவெளியில் இருக்கும் Kubernetes API ஒரு இலக்காகவே இருக்கும். இவ்வாறு வெளிப்படையாக இருக்கும் சிறிய cluster-கள், மற்றவர்களுக்காக cryptocurrency mining செய்யும் தளங்களாக மாறக்கூடும். SSH மூலம் tunnel செய்து, கோப்பில் உள்ள முகவரியை மாற்றாமல் அப்படியே விடவும்:

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

நீங்கள் ஒரு private network முகவரி வழியாக 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

ஒரு cluster-க்கான உள்வரும் (inbound) ports-கள்: API-க்காக TCP 6443, nodes-களுக்கு இடையே flannel VXLAN-க்காக UDP 8472, மற்றும் kubelet metrics-க்காக TCP 10250. ஒற்றை node-ல், இவற்றில் எதையும் இணையத்திற்குத் திறந்து வைக்க வேண்டிய அவசியமில்லை.

containerd என்பது Docker அல்ல

k3s அதன் சொந்த உட்பொதிக்கப்பட்ட (embedded) containerd-ஐ இயக்குகிறது. இது Docker-உடன் image store-ஐப் பகிர்ந்துகொள்வதில்லை. docker build மூலம் நீங்கள் உருவாக்கிய ஒரு image, k3s-க்குத் தெரியாது. எனவே, docker images கட்டளையில் அந்த image தெரிந்தாலும், pod ErrImagePull பிழையுடன் தோல்வியடையும். அதை நேரடியாக import செய்யவும்:

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

அதன்பிறகு, அந்த container-க்கு :latest tag-ஐப் பயன்படுத்துவதைத் தவிர்க்கவும். ஏனெனில், :latest இயல்பாகவே Always என்ற imagePullPolicy-ஐப் பயன்படுத்தும், இதனால் kubelet பதிவேட்டிற்கு (registry) சென்று தேடும். வேறு எந்த tag-ஐப் பயன்படுத்தினாலும் அது இயல்பாகவே IfNotPresent-க்கு மாறும், இது நீங்கள் import செய்த image-ஐப் பயன்படுத்தும். ஒரே VPS-ல் இரண்டையும் இயக்குவது சாத்தியம். VPS-ல் ஒரு சாதாரண Docker நிறுவல் மற்றும் k3s ஆகிய இரண்டும் ஒரே கணினியில் தத்தமது சொந்த image store மற்றும் iptables விதிகளைப் பராமரிக்கின்றன என்பதைப் புரிந்துகொள்வது அவசியம்.

k3s-ஐ அகற்றுவது எப்படி

installer ஒரு uninstall script-ஐ உருவாக்குகிறது. இதில் பகுதியளவு அகற்றுதல் (partial removal) அல்லது மாற்றங்களை மீளப்பெறுதல் (undo) செய்ய முடியாது.

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

இது service-ஐ நிறுத்தி நீக்குகிறது, datastore-ஐ அழிக்கிறது, persistent volume தரவுகளை நீக்குகிறது, node configuration-ஐ அகற்றுகிறது, மேலும் installer சேர்த்த கருவிகளையும் நீக்குகிறது. ஒரு agent node-ல், இந்த script-க்கு பதிலாக k3s-agent-uninstall.sh பயன்படுத்தப்படுகிறது. /var/lib/rancher/k3s/storage-ன் கீழ் உள்ள எதையும் முதலில் server-லிருந்து நகலெடுத்து வைத்துக்கொள்ளுங்கள், ஏனெனில் அந்த directory-யும் சேர்த்து நீக்கப்படும். அதன் பிறகு, ip link show மற்றும் sudo ss -lntp மூலம் எந்தவொரு port-ம் அல்லது interface-ம் பயன்பாட்டில் இல்லை என்பதை உறுதிப்படுத்தவும். எஞ்சியிருக்கும் cni0 அல்லது flannel.1 interface அடுத்த முறை reboot செய்யும்போது தானாகவே நீங்கிவிடும்.

Kubernetes-ன் ஒரு node என்பது தேவைக்கு அதிகமான கட்டமைப்பு என்று முடிவெடுப்பது தோல்வியல்ல, அது ஒரு இயல்பான முடிவுதான். அந்த workloads-ஐ மீண்டும் Compose-க்கு மாற்றுவதற்கு பொதுவாக ஒரு மதிய நேரம் போதுமானது.

தோல்வி முறைகள் மற்றும் நீங்கள் காணும் சரங்கள் (strings)

Node NotReady, அல்லது k3s லூப்பில் மீண்டும் தொடங்குகிறது. முதலில் 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-ஐப் பதிவிறக்க முடியவில்லை. Image பெயர் மற்றும் tag, registry அணுகல் மற்றும் நற்சான்றிதழ்கள் (credentials), அல்லது நீங்கள் Docker மூலம் image-ஐ உருவாக்கி அதை containerd-க்குள் இறக்குமதி செய்யாமல் விட்டீர்களா என்பதைச் சரிபார்க்கவும்.

Traefik பதிலளிக்கிறது, ஆனால் app பதிலளிக்கவில்லை. 404 page not found என்ற response body Traefik-லிருந்து வருகிறது; அதாவது கோரிக்கை வந்துவிட்டது, ஆனால் எந்த 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-க்கு கோரிக்கையை அனுப்பி, அது மீண்டும் அதற்கே திருப்பி அனுப்பப்படுவதால் இது நிகழ்கிறது; இதுதான் /etc/resolv.conf-ல் உள்ள loopback முகவரி செய்யும் காரியம். --resolv-conf /run/systemd/resolve/resolv.conf மூலம் k3s-ஐ உண்மையான upstream கோப்பிற்குச் சுட்டிக்காட்டவும்.

FAQ

ஒரு single VPS-ல் k3s-ஐ இயக்குவது பயனுள்ளதா?

உங்களுக்கு Kubernetes API தேவைப்படும்போது இது பயனுள்ளது: உங்கள் கட்டுப்பாட்டில் உள்ள ஒரு machine-ல் அதைக் கற்றுக்கொள்ள, deployments-ஐ manifests-ஆக போர்ட்டபிளாக வைத்திருக்க, Helm chart-ஐ மட்டுமே வெளியிடும் மென்பொருளை இயக்க, அல்லது பிற்காலத்தில் managed cluster-க்கு மாற்றக்கூடிய ஒன்றை உருவாக்க இது உதவும். உங்களுக்கு containers-ஐ இயக்க மட்டுமே தேவை என்றால், இது பயனுள்ளது அல்ல; ஏனெனில் Docker Compose-ஐ பராமரிப்பது எளிது மற்றும் இது சுமார் ஒரு gigabyte RAM-ஐ மிச்சப்படுத்தும். ஒரு node-ல் high availability கிடையாது, எனவே நம்பகத்தன்மைக்காக இதைத் தேர்வு செய்ய வேண்டாம்.

எனது k3s LoadBalancer service ஏன் Pending நிலையிலேயே உள்ளது?

ServiceLB ஆனது svclb- pods-ஐ உருவாக்குகிறது. இவை node-ல் உள்ள service-ன் ports-ஐ hostPort-ஆகக் கோருகின்றன, எனவே அந்த ports காலியாக உள்ள இடங்களில் மட்டுமே இவை இயங்கும். மற்றொரு Kubernetes pod ஏற்கனவே அதே hostPort-ஐப் பயன்படுத்தினால், அந்த pod Pending நிலையிலேயே இருக்கும் மற்றும் service-க்கு external address கிடைக்காது. port 80-ல் இயங்கும் ஒரு host proxy அல்லது standalone Docker container இந்த scheduling நிராகரிப்பை நேரடியாக ஏற்படுத்தாது. 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 ஒதுக்கீட்டை நீக்கவும், அல்லது --disable=servicelb மூலம் ServiceLB-ஐ முடக்கிவிட்டு, service ஒதுக்கும் NodePort-க்கு proxy செய்யவும்.

ஒரு VPS-ல் k3s-க்கு எவ்வளவு RAM தேவை?

server node-க்கான குறைந்தபட்ச தேவை 2 cores மற்றும் 2 GB RAM ஆகும். இது உங்கள் workloads தொடங்குவதற்கு முன்பே k3s மற்றும் அதன் தொகுக்கப்பட்ட கூறுகளுக்குத் தேவைப்படும் அளவு. திட்டத்தின் சொந்த profiling, ஒரு server node-ன் control plane மற்றும் datastore-க்கு 1,596 MB தேவைப்படுவதாகக் காட்டுகிறது (monitoring stack இயங்கும்போது). இந்த அளவில் workload-ன் memory சேர்க்கப்படவில்லை, எனவே 2 GB-ஐ அடிப்படை அளவாகவும், 4 GB-ஐ ஒரு node வசதியாக இயங்கக்கூடிய அளவாகவும் கருதவும். நிறுவுவதற்கு முன்பும், kube-system-ல் உள்ள அனைத்து pods-ம் Running நிலைக்கு வந்த பிறகும் free -h மூலம் உங்கள் box-ன் அளவீட்டைச் சரிபார்க்கவும்.

ஒரே VPS-ல் Docker மற்றும் k3s-ஐ இயக்க முடியுமா?

ஆம், அவை தனித்தனியாகவே இயங்கும். k3s அதன் சொந்த embedded containerd-ஐப் பயன்படுத்துகிறது, எனவே docker build மூலம் உருவாக்கப்பட்ட image, நீங்கள் docker save myapp:0.1 | sudo k3s ctr images import --ஐ இயக்கும் வரை k3s-க்குத் தெரியாது. ஒவ்வொன்றும் அதன் சொந்த iptables விதிகள் மற்றும் bridge networks-ஐ உருவாக்கும். Docker, k3s மற்றும் உங்கள் containers அனைத்தும் ஒரே box-ன் RAM-ஐப் பகிர்வதால், மொத்த memory பயன்பாட்டைக் கண்காணிக்கவும்.

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 தரவுகளை அழித்து, தொகுக்கப்பட்ட கருவிகளை நீக்கும். நீங்கள் வைத்திருக்க விரும்பும் தரவுகளை முதலில் box-லிருந்து நகலெடுக்கவும், ஏனெனில் இதைத் திரும்பப் பெற முடியாது. எஞ்சியிருக்கும் cni0 அல்லது flannel.1 network interface அடுத்த reboot-ல் மறைந்துவிடும்.

இந்தக் கட்டுரை பயனுள்ளதாக இருந்ததா?

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