Tek sunucuda k3s kurulumu: Ne zaman tercih edilmeli?
Tek bir VPS üzerinde k3s kullanmanın avantajlarını ve RAM maliyetlerini inceleyin. 80 portu çakışması ve Docker Compose ile kıyaslamalar hakkında detaylı teknik bilgiler.
k3s nedir ve tek bir düğüm size ne sağlar
k3s, tek bir binary dosyası olarak paketlenmiş tam bir Kubernetes dağıtımıdır. Bunu tek bir VPS üzerinde çalıştırmak, üç makineli bir kontrol düzlemine ihtiyaç duymadan gerçek Kubernetes API'sine sahip olmanızı sağlar. Sertifikalı bir Kubernetes dağıtımı olduğu için, burada uygulanan bir manifest dosyası daha sonra yönetilen bir cluster üzerinde de çalışır. Kurulum tek bir komutla yaklaşık bir dakikada tamamlanır. Bunun bedeli, uygulamalarınız için artık kullanılamayacak olan bellek miktarı ve Docker Compose ile asla karşılaşılmayan bir dizi hata modudur.
SUSE, k3s'i uç noktalar ve küçük kurulumlar için geliştirmiştir; upstream Kubernetes'ten farkları, onu daha küçük ve çalıştırılması daha basit hale getirmek içindir. Varsayılan veri deposu etcd değil, kine adlı bir katman arkasındaki sqlite'tır; bu nedenle yönetilmesi gereken bir etcd çoğunluğu (quorum) yoktur. containerd, ayrı olarak kurulmak yerine binary içine gömülüdür. Aynı binary dosyası; cluster DNS için CoreDNS'i, ingress controller olarak Traefik'i, arkasında bir bulut sağlayıcı olmadan LoadBalancer servislerinin çalışmasını sağlayan ServiceLB'yi (klipper-lb olarak da bilinir), kalıcı birimler için local-path provisioner'ı, metrics-server'ı ve pod ağ iletişimi için flannel'ı beraberinde getirir. Bunların her biri varsayılan olarak başlar. Bu varsayılan ayarlar Traefik'i 80 ve 443 numaralı portlara yerleştirir; bu nedenle halihazırda başka bir servis sunan bir VPS üzerine kurulum yapmadan önce bu portları kimin kullanacağına karar verin.
Tek bir k3s düğümünün avantajlı olduğu durumlar
Kubernetes API'sine ihtiyaç duyduğunuzda k3s kullanın: kontrolünüz altındaki bir makinede Kubernetes öğreniyorsanız veya kullanmak istediğiniz yazılım yalnızca bir Helm chart olarak sunuluyorsa bu doğru tercihtir. Manifest taşınabilirliği de önemlidir; burada yazdığınız bir Deployment, yönetilen bir kümeye hiçbir değişiklik yapılmadan taşınabilir. Uygulamalar önceliğiniz olduğunda Docker Compose kullanın. Compose, aynı container'ları çok daha az hareketli parça ile başlatır ve bir VPS üzerindeki Compose dosyası, bir yıl sonra bir manifest dizininden çok daha kolay okunur.
Tek bir düğümün size neler sağlamadığını netleştirin.
- Yüksek erişilebilirlik yoktur. VPS yeniden başlatıldığında tüm iş yükleri durur. Kubernetes bir pod'u başka bir düğüme yeniden zamanlamaya çalışır ancak başka bir düğüm yoktur.
- Uygulama tek bir makinede iki replikayı tolere ediyorsa ve düğüm ikisi için de yeterli alana sahipse, servisi ayakta tutan bir rolling update (kademeli güncelleme) mümkündür; aksi takdirde bu mümkün değildir.
- Aşağıdaki local-path bölümünde açıklanan nedenlerden dolayı, depolama birimi doğrudan sunucuya bağlıdır.
- Herhangi bir şey dağıtsanız da dağıtmasanız da yaklaşık bir gigabayt RAM tüketen bir kontrol düzlemi (control plane) vardır.
Bunların hiçbiri k3s'i kötü bir tercih yapmaz. İnsanların genellikle belirttiği güvenilirlik gerekçesiyle k3s'i kötü bir tercih haline getirir. Eğer gerçekten istediğiniz şey, gerçek bir çok düğümlü küme oluşturabilmek için birden fazla makineye sahip olmaksa, bu karar önceliklidir: Kendi donanımınızda Proxmox ile kiralanan VPS karşılaştırması, k3s üzerinde neyin çalışacağına karar vermeden önce düğümlerin nereden geleceğini belirler.
Herhangi bir şey dağıtmadan önce k3s'in RAM ve CPU maliyeti
k3s projesi tahminler yerine ölçülmüş değerleri yayınlar. Bu değerleri dikkatle okuyun; çünkü insanların telaffuz ettiği rakamlar boşta çalışan k3s'i yansıtmaz.
Bu grafiğin arkasındaki veriler
[
{
"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
}
]Bu testteki bir sunucu düğümü, 95. yüzdelik dilimde 1,596 MB RAM ve tek bir çekirdeğin yaklaşık 6 kadarını kullanmıştır. Bunlar yayınlanmış rakamlardır, bu rehberdeki ölçümler değildir. Test, tüm paketlenmiş bileşenleri etkinleştirilmiş, ayrıca Prometheus ve Grafana izleme yığını kurulu k3s v1.26.5 sürümü ile gerçekleştirilmiştir; yani küme boş değil meşguldür. Ancak proje, bu rakamların yalnızca Kubernetes veri deposunu ve kontrol düzlemini kapsadığını, iş yüküne özel gereksinimleri içermediğini belirtir. Kendi container'larınız bunun üzerine eklenir. sqlite yerine gömülü etcd kullanılması kullanımı 1,606 MB seviyesine taşımıştır. Kontrol düzlemi olmadan yalnızca kubelet ve containerd çalıştıran bir aracı düğüm ise 275 MB kullanmıştır. Bir sunucu için belgelenen minimum değer 2 çekirdek ve 2 GB RAM'dir; bu minimum değer, iş yüklerinizden önce k3s ve paketlenmiş bileşenlerini kapsar.
Pratik çıkarım şudur: 2 GB'lık bir VPS üzerinde kontrol düzlemi ve beraberinde gelen eklentiler size çok az alan bırakır. Bellek baskısı altında kubelet pod'ları tahliye eder, ancak bellek kullanımı hızla artarsa çekirdeğin OOM killer'ı, kubelet baskıyı algılamadan önce devreye girebilir. 4 GB, birkaç küçük servis çalıştıran tek bir düğüm için rahat bir alt sınırdır. Yayınlanmış herhangi bir rakama (buna dahil) güvenmek yerine kendi sunucunuzu ölçün.
free -h
sudo k3s kubectl top node
sudo k3s kubectl get pods -AKurulumdan önce ve kube-system içindeki her pod Running durumuna geçtikten sonra free -h komutunu çalıştırın. Aradaki fark, kontrol düzleminin donanımınızdaki maliyetidir. k3s kubectl top node, kurulumdan sonraki ilk bir veya iki dakika boyunca error: Metrics API not available döndürür; çünkü metrics-server henüz hiçbir veriyi çekmemiştir. Bu bir hata değildir. Eğer tek bir sunucuyu hem bunun için hem de aynı anda başka işler için boyutlandırıyorsanız, VPS için RAM ve CPU boyutlandırma bölümündeki hesaplama burada da aynen geçerlidir.
k3s kurulumunu en güncel sürüme değil, belirli bir sürüme sabitleme
Herkesin kopyaladığı hızlı başlangıç komutu, çalıştırdığınız gün stable kanalının işaret ettiği sürümü kurar. Uzun süreli kullanmayı planladığınız bir makinede sürümü sabitleyin. k3s, her Kubernetes alt sürümü için bir kanal yayınlar; bu nedenle INSTALL_K3S_CHANNEL=v1.36, v1.36 içindeki yama sürümlerini takip eder ve siz istemeden bir alt sürüme geçiş yapmaz. Ekim 2026 itibarıyla stable kanalı v1.36.5+k3s1 sürümünü işaret etmektedir.
Önce yapılandırma dosyasını oluşturun, ardından kurulumu gerçekleştirin. k3s, başladığında /etc/rancher/k3s/config.yaml dosyasını okur; bu nedenle dosya içindeki tüm ayarlar ilk açılışta ve sonraki tüm başlatmalarda geçerli olur.
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 -Bir kanalı değil de tam olarak belirli bir sürümü sabitlemek için INSTALL_K3S_VERSION=v1.36.5+k3s1 kullanın. Artı işareti, etiket adının bir parçasıdır. Ardından servisin ayağa kalkıp kalkmadığını kontrol edin.
k3s --version
sudo systemctl status k3s
sudo k3s kubectl get node
sudo k3s kubectl get pods -Akubectl get node, yaklaşık otuz saniye içinde STATUS değeri Ready olan bir düğüm listelemelidir ve kube-system içindeki tüm pod'lar Running veya Completed durumuna ulaşmalıdır. NotReady durumunda takılı kalan bir düğüm, genellikle container çalışma zamanının hiç başlamadığı anlamına gelir; bu durumda sudo journalctl -u k3s -n 100 --no-pager dosyasını inceleyin. Alışılmadık bir VPS imajı kullanıyorsanız, başka bir hata ayıklama işlemine geçmeden önce sudo k3s check-config komutunu çalıştırın: bu komut, eksik çekirdek özelliklerini raporlar ve günlük kayıtlarını okumaktan çok daha hızlı bir sonuç verir.
80 numaralı port neden kullanımda ve sorunu çözmek için nelerden vazgeçilmeli
Bu hata, halihazırda başka bir servis çalıştıran bir VPS üzerinde kurulum yapan kullanıcıların sıkça karşılaştığı bir durumdur. Kurulum başarıyla tamamlanır ancak başka bir Kubernetes pod'u aynı düğüm üzerinde aynı hostPort değerini rezerve etmişse, Traefik hiçbir zaman bir adres alamaz.
Mekanizma şu şekildedir: Dahili Traefik chart'ı, 80 ve 443 numaralı portlarda LoadBalancer tipinde bir Service oluşturur. ServiceLB, bu isteği karşılamak için her düğümde bu port numaralarını hostPort olarak talep eden ve svclb- ön ekiyle adlandırılan küçük pod'lardan oluşan bir DaemonSet oluşturur. hostPort, ağ kuralları aracılığıyla trafiği düğüm portundan pod'a yönlendirir. Zamanlayıcı (scheduler), ana makine servisleri veya bağımsız Docker container'ları tarafından tutulan soketleri değil, Kubernetes pod'ları tarafından beyan edilen host portlarını kontrol eder. Aynı hostPort'u rezerve eden başka bir pod, zamanlamayı engeller; ancak 80 numaralı portu dinleyen bir nginx, Caddy, Apache veya bağımsız bir Docker container'ı, zamanlayıcının bu reddine doğrudan neden olmaz.
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 )'Başka bir Kubernetes pod'undan kaynaklanan çakışan bir hostPort rezervasyonu olduğunda, svclb pod'unun Pending durumunda kaldığını ve servisin harici bir adresi olmadığını görürsünüz:
svclb-traefik-8f2c1a-r6k9x 0/2 Pending 0 3m
traefik LoadBalancer 10.43.62.11 <pending> 80:31480/TCP,443:30219/TCPkubectl -n kube-system describe pod svclb-traefik-... komutunu çalıştırmak, sorunun nedenini doğrudan belirtir:
0/1 nodes are available: 1 node(s) didn't have free ports for the requested pod ports.ss -lntp komutu, portu hangi sürecin dinlediğini söyler; ancak zamanlayıcının kontrol ettiği hostPort rezervasyonlarını göstermez. Bu durumdan kurtulmanın birden fazla yolu vardır ve her birinin bir maliyeti bulunur.
Portları k3s'e bırakın. Başka bir Kubernetes pod'undaki çakışan hostPort rezervasyonunu kaldırın, ardından mevcut web sunucusunu durdurup devre dışı bırakın; böylece Traefik 80 ve 443 numaralı portlardaki gelen trafiği yönetebilir. VPS yalnızca bir k3s sunucusu olarak kullanılacaksa ve sunduğunuz her şey bir Ingress arkasına taşınacaksa en doğru yöntem budur.
ServiceLB'yi devre dışı bırakın ve mevcut proxy'nizi koruyun. Kurulumu --disable=servicelb ile yapın. LoadBalancer tipindeki bir Service yine de bir NodePort tahsis eder, bu sayede Traefik 31480 gibi yüksek bir port üzerinden erişilebilir kalır ve nginx veya Caddy proxy'niz trafiği 127.0.0.1:31480 adresine yönlendirir. Bu durumda vazgeçtiğiniz şey harici adrestir: servis sürekli olarak <pending> değerini raporlar; bu durum bir tercih olmasına rağmen bir hata gibi görünebilir.
Traefik'i devre dışı bırakın ve kendi proxy'nizle yönlendirme yapın. Kurulumu --disable=traefik ile yapın. Bu durumda bir ingress controller'ınız olmaz, dolayısıyla Ingress nesneleri hiçbir işlev görmez: onları izleyen bir controller olmadığı için API içerisinde pasif kalırlar. Bir ana makine proxy'sinden NodePort'lara yönlendirme yapıyorsanız bu yöntem uygundur ve HTTP trafiğinin nasıl yönetilmesi gerektiğini zaten biliyorsanız en dürüst tercihtir. Ön tarafta neyin yer alması gerektiği konusunda kararsızsanız, herhangi bir şeyi devre dışı bırakmadan önce reverse proxy olarak nginx, Caddy ve Traefik arasındaki seçim konusunu netleştirin.
Her iki bayrak da yükleyiciye veya yapılandırma dosyasına eklenmelidir:
tls-san:
- k3s.example.com
disable:
- traefik
- servicelbKurulumdan sonra bu dosyayı düzenleyip sudo systemctl restart k3s komutunu çalıştırmak da işe yarar, çünkü --disable kurulum sırasında bir bileşeni atlamaktan daha fazlasını yapar. Ayrıca halihazırda dağıtılmış olan bir bileşeni siler, böylece değişiklik çalışan bir küme üzerinde etkili olur.
Traefik'i tutmak ancak chart'ın yapılandırma şeklini değiştirmek istiyorsanız, /var/lib/rancher/k3s/server/manifests/traefik.yaml dosyasını düzenlemeyin. k3s, her başlatıldığında bu dosyayı varsayılan değerlerle yeniden yazar. Bunun yerine aynı dizinde ayrı bir dosya ekleyin; çünkü /var/lib/rancher/k3s/server/manifests içindeki her şey başlangıçta ve disk üzerinde her değiştiğinde otomatik olarak uygulanır.
apiVersion: helm.cattle.io/v1
kind: HelmChartConfig
metadata:
name: traefik
namespace: kube-system
spec:
valuesContent: |-
ports:
web:
forwardedHeaders:
trustedIPs:
- 10.0.0.0/8Bu örnek, güvenilir proxy adresleri olan bir Traefik chart değerini ayarlar. Aynı mekanizma, portları dahil olmak üzere chart'ın sunduğu diğer tüm değerleri ayarlamak için de kullanılır.
Tek düğüm üzerinde kalıcı depolama
k3s, varsayılan olarak Rancher'ın local-path provisioner altyapısını kullanan local-path adlı bir StorageClass ile gelir. Herhangi bir storageClassName belirtilmeyen PersistentVolumeClaim talepleri bu sınıfı kullanır. Birimler, düğümün kendi diski üzerinde, her birim için ayrı bir alt dizin olacak şekilde /var/lib/rancher/k3s/storage altında tutulur.
sudo k3s kubectl get storageclass
sudo k3s kubectl get pvc -A
sudo ls -l /var/lib/rancher/k3s/storage"Düğümün kendi diski üzerinde" ifadesinin iki sonucu vardır ve her ikisi de bugün değil, ileride sorun yaratır.
StorageClass, volumeBindingMode: WaitForFirstConsumer kullandığı için yeni bir PVC, bir pod onu gerçekten mount edene kadar Pending durumunda kalır. kubectl describe pvc komutu şu çıktıyı verir:
waiting for first consumer to be created before bindingBu normal bir durumdur; dolayısıyla bir PVC'yi tek başına oluşturup beklemek, durumun değişmesini sağlamaz.
Birim bağlandığında (bound), birimi oluşturan düğüme yönelik bir düğüm yakınlığı (node affinity) kazanır. Bu durum, söz konusu talebi kullanan her pod'u, birimin ömrü boyunca o düğüme sabitler. Tek düğümlü bir yapıda bunu fark etmezsiniz. İleride ikinci bir düğüm eklediğinizde, taşınmayı reddeden bir pod, siz kubectl get pv -o yaml komutunu çalıştırıp nodeAffinity içerisinde hostname bilgisini görene kadar bir zamanlayıcı (scheduler) hatası gibi görünür.
Yedeklemeler sizin sorumluluğunuzdadır. VPS'i yeniden oluşturmak bu dizini siler; aşağıdaki kaldırma betiği de aynı işlemi yapar. /var/lib/rancher/k3s/storage dizinini, servis durdurulmuş haldeyken kopyalanan /var/lib/rancher/k3s/server/db/ sqlite veri deposu dizinini ve /var/lib/rancher/k3s/server/token konumundaki sunucu token dosyasını yedekleyin. Token isteğe bağlı değildir: k3s belgeleri, veri deposunu yedekten geri yüklerken bu dosyayı geri yüklemeniz veya değerini --token parametresine aktarmanız gerektiğini belirtir. Alternatif yol, kümeyi geçici olarak kabul edip her manifest dosyasını git üzerinde tutmaktır.
Ingress ve TLS
Traefik etkin bırakıldığında, standart bir Ingress nesnesi yeterlidir.
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: 80Sertifikalar kendiliğinden oluşmaz. Bunun için genel kabul görmüş çözüm, yayınlanan manifest dosyası üzerinden kurulan cert-manager ve buna ek olarak bir adet ClusterIssuer kullanmaktır. 23 Ekim 2026 tarihinde yayınlanan v1.21.3 sürümü, Ekim 2026 itibarıyla güncel sürümdür.
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: traefikHTTP-01 sınaması, ACME (otomatik sertifika yönetim ortamı) sunucusunun genel internet üzerinden http://hello.example.com/.well-known/acme-challenge/... adresine bağlanması anlamına gelir. Bu nedenle, alan adının DNS kaydı (VPS IPv6 üzerinden erişilebilir durumdaysa A kaydı veya AAAA kaydı) halihazırda VPS'i işaret etmeli ve 80 numaralı port Traefik'e ulaşabilmelidir. Her iki adres türü de mevcut olduğunda Let’s Encrypt önce IPv6 adresini dener, ancak ilk IPv6 bağlantısı zaman aşımına uğrarsa IPv4'e geri döner. Yanlış sınama yanıtı dahil olmak üzere diğer hatalar bu geri dönüşü tetiklemez ve yönlendirilen istekler için yeniden deneme yapılmaz. Güncelliğini yitirmiş AAAA kayıtlarını düzeltin veya kaldırın. Eğer ServiceLB'yi devre dışı bırakıp kendi proxy'nizi öne koyduysanız, bu proxy'nin sınama yolunu da iletmesi gerekir; aksi takdirde cert-manager, Challenge nesnesi üzerinde şu hata ile takılı kalır:
Waiting for HTTP-01 challenge propagation: wrong status code '404', expected '200'Sertifika oluşturma sürecini sudo k3s kubectl describe certificate hello-tls ve sudo k3s kubectl get order,challenge -A komutlarıyla izleyin.
kubeconfig dosyası ve API sunucusunun neden özel tutulduğu
k3s, yönetici kimlik bilgilerini /etc/rancher/k3s/k3s.yaml dosyasına yazar. Bu dosyanın sahibi varsayılan olarak root kullanıcısıdır ve 600 izin moduyla oluşturulur. Dosya, cluster-admin yetkilerine sahip bir istemci sertifikası içerir; bu nedenle dosyayı okuyabilen herkes kümenin tam denetimine sahip olur.
sudo k3s kubectl get node
export KUBECONFIG=/etc/rancher/k3s/k3s.yaml
kubectl get nodeAyrı olarak kurulan kubectl, k3s dosyasından haberdar değildir. KUBECONFIG değişkeni ayarlanmadığında ~/.kube/config dosyasını okumaya çalışır; bu dosya mevcut değilse, yapılandırılmış bir küme bulunamadığı için The connection to the server localhost:8080 was refused - did you specify the right host or port? hatasıyla başarısız olur. KUBECONFIG değişkenini ayarlayın, dosyayı aşağıda gösterildiği gibi ~/.kube/config konumuna kopyalayın veya doğrudan doğru dosyayı okuyan sudo k3s kubectl komutunu kullanın.
Normal bir kullanıcının kubectl komutunu çalıştırabilmesi için genellikle --write-kubeconfig-mode 644 komutunun önerildiğini göreceksiniz. Bu işlemin ne anlama geldiğini kavrayın: cluster-admin kimlik bilgilerini makinedeki tüm yerel hesaplar tarafından okunabilir hale getirir. Tek bir yöneticinin bulunduğu bir sistemde bu kabul edilebilir bir risk olabilir, ancak paylaşımlı bir sistemde kesinlikle değildir. Dosyayı kopyalamak, kimlik bilgilerini genel erişime açmadan yalnızca ilgili kullanıcıya yetki verir:
mkdir -p ~/.kube
sudo install -o $USER -g $USER -m 600 /etc/rancher/k3s/k3s.yaml ~/.kube/configDosya içindeki server: satırı https://127.0.0.1:6443 değerini içerir. kubectl komutunu dizüstü bilgisayarınızdan kullanmak için 6443 numaralı portu internete açmayın. Genel erişime açık bir Kubernetes API'si sürekli bir hedeftir; küçük kümelerin başkaları adına kripto para madenciliği yapmaya başlamasının temel nedeni, bu portların dış dünyaya açık bırakılmasıdır. API'ye SSH üzerinden tünel kurun ve dosyadaki adresi değiştirmeyin:
ssh -N -L 6443:127.0.0.1:6443 user@your-vps
KUBECONFIG=./k3s.yaml kubectl get nodeAPI'ye özel bir ağ adresi üzerinden erişmeniz gerekiyorsa, kurulumu bu ismi veya adresi içeren tls-san parametresiyle yapın ve ardından kopyalanan dosyadaki server: satırını buna göre düzenleyin. SAN (subject alternative name) girişi olmadan kubectl bağlantıyı reddeder:
x509: certificate is valid for 127.0.0.1, 10.43.0.1, not 203.0.113.10Bir küme için belgelenen gelen portlar; API için TCP 6443, düğümler arası flannel VXLAN trafiği için UDP 8472 ve kubelet metrikleri için TCP 10250'dir. Tek düğümlü bir kurulumda, bu portların hiçbirinin internete açık olması gerekmez.
containerd, Docker değildir
k3s kendi gömülü containerd sürümünü çalıştırır ve Docker ile ortak bir imaj deposu kullanmaz. docker build ile yeni oluşturduğunuz bir imaj k3s tarafından görülmez; bu nedenle docker images komutu imajı listelese bile pod ErrImagePull hatası verir. İmajı şu şekilde açıkça içe aktarın:
docker save myapp:0.1 | sudo k3s ctr images import -
sudo k3s crictl imagesArdından, o container üzerinde :latest etiketini kullanmaktan kaçının. Çünkü :latest, varsayılan olarak Always değerinde bir imagePullPolicy kullanır ve kubelet her durumda bir kayıt defterine (registry) yönelir. Diğer tüm etiketler, içe aktardığınız imajı kullanan IfNotPresent varsayılanına sahiptir. Her ikisini de tek bir VPS üzerinde çalıştırmak mümkündür; bu noktada bir VPS üzerinde standart Docker kurulumu ile k3s'in kendi imaj depolarını ve kendi iptables kurallarını aynı makine üzerinde ayrı ayrı yönettiklerini bilmek faydalıdır.
k3s nasıl kaldırılır
Yükleyici, bir kaldırma betiği oluşturur. Kısmi kaldırma veya geri alma işlemi desteklenmez.
sudo /usr/local/bin/k3s-uninstall.shBu betik servisi durdurur ve kaldırır, veri deposunu siler, kalıcı birim (persistent volume) verilerini siler, düğüm yapılandırmasını kaldırır ve yükleyicinin eklediği araçları temizler. Bir aracı (agent) düğümünde betik bunun yerine k3s-agent-uninstall.sh komutudur. /var/lib/rancher/k3s/storage altındaki her şeyi öncelikle sunucudan başka bir yere kopyalayın, çünkü bu dizin işlemle birlikte silinecektir. İşlem sonrasında, ip link show ve sudo ss -lntp komutlarını kullanarak portları veya ağ arayüzlerini tutan herhangi bir öğe kalmadığından emin olun. Geride kalan bir cni0 veya flannel.1 arayüzü, bir sonraki yeniden başlatmada temizlenecektir.
Kubernetes düğümünün iş yükü için gereğinden fazla karmaşık olduğuna karar vermek, bir başarısızlık değil, olağan bir sonuçtur. Bu iş yüklerini tekrar Compose yapısına taşımak genellikle bir öğleden sonra sürecek bir işlemdir.
Hata modları ve karşılaşacağınız dizgeler
Node NotReady durumu veya k3s'in sürekli yeniden başlaması. Öncelikle sudo journalctl -u k3s -n 200 --no-pager kısmını okuyun. Küçük bir VPS üzerinde en yaygın neden, çekirdeğin bellek yetersizliği (OOM killer) nedeniyle süreci sonlandırmasıdır; bu durum dmesg içerisinde k3s-server ifadesini içeren bir satırla belirtilir. Belgelenen 2 GB minimum bellek gereksinimi gerçek bir alt sınırdır.
Pod Pending durumunda takılı kalıyor. kubectl describe pod her seferinde durumu belirtir. Insufficient memory veya Insufficient cpu, düğümde yer kalmadığı anlamına gelir. didn't have free ports, başka bir Kubernetes pod'unun çakışan bir hostPort rezerve ettiği anlamına gelir. Bir PVC üzerindeki waiting for first consumer, WaitForFirstConsumer özelliğinin görevini yaptığını gösterir.
ImagePullBackOff. Düğüm görüntüyü çekemedi. Görüntü adını ve etiketini, kayıt defteri erişimini ve kimlik bilgilerini kontrol edin veya görüntüyü Docker ile oluşturup containerd içerisine aktarıp aktarmadığınızı doğrulayın.
Traefik yanıt veriyor ancak uygulama vermiyor. 404 page not found yanıt gövdesi doğrudan Traefik'ten gelir ve isteğin ulaştığını ancak eşleşen bir yönlendirici (router) bulunamadığını gösterir. Ingress host değerinin yazdığınız isimle eşleştiğinden ve ingressClassName değerinin traefik olduğundan emin olun.
Küme DNS'i başarısız oluyor ancak ana makine çözümleme yapabiliyor. CoreDNS'i sudo k3s kubectl -n kube-system logs -l k8s-app=kube-dns ile kontrol edin. plugin/loop: Loop ... detected for zone "." gibi bir mesaj CoreDNS'in başlamasını engeller. Bu durum, CoreDNS'in kendisine geri yönlendirme yapan bir çözümleyiciye istek göndermesi nedeniyle oluşur; /etc/resolv.conf içerisindeki bir loopback adresi buna neden olur. k3s'i --resolv-conf /run/systemd/resolve/resolv.conf kullanarak gerçek üst akış (upstream) dosyasına yönlendirin.
FAQ
Tek bir VPS üzerinde k3s çalıştırmaya değer mi?
Kubernetes API'sine ihtiyaç duyduğunuzda buna değer: kontrol ettiğiniz bir makinede öğrenmek, dağıtımları manifest dosyaları olarak taşınabilir tutmak, yalnızca Helm chart yayınlayan yazılımları çalıştırmak veya daha sonra yönetilen bir kümeye taşıyacağınız bir yapı kurmak buna örnektir. Yalnızca konteyner çalıştırmak istiyorsanız buna değmez; çünkü Docker Compose bunu çok daha az bakım gereksinimiyle ve yaklaşık bir gigabayt daha fazla boş RAM ile yapar. Tek düğüm size yüksek erişilebilirlik sağlamaz, bu nedenle güvenilirlik onu seçmek için hiçbir zaman bir neden değildir.
k3s LoadBalancer servisim neden Pending durumunda kalıyor?
ServiceLB, servisin portlarını düğüm üzerinde hostPort olarak talep eden svclb- pod'larını oluşturur, bu nedenle yalnızca bu portların boş olduğu yerlerde zamanlanırlar. Eğer başka bir Kubernetes pod'u aynı hostPort'u zaten rezerve etmişse, pod Pending durumunda kalır ve servis hiçbir zaman harici bir adres alamaz. 80 numaralı portu dinleyen bir ana makine proxy'si veya bağımsız bir Docker konteyneri, tek başına bu zamanlama reddine neden olmaz. 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 raporunu verir. Çakışan pod'un hostPort rezervasyonunu kaldırın veya --disable=servicelb ile ServiceLB'yi devre dışı bırakıp servisin hala tahsis ettiği NodePort'a proxy yapın.
k3s bir VPS üzerinde ne kadar RAM'e ihtiyaç duyar?
Bir sunucu düğümü için belgelenen minimum değer 2 çekirdek ve 2 GB'tır; bu, iş yüklerinizden önce k3s ve paketlenmiş bileşenlerini kapsar. Projenin kendi profil oluşturma çalışmaları, bir sunucu düğümünün kontrol düzlemini ve veri deposunu, üzerinde bir izleme yığını çalışırken 1,596 MB olarak ölçmüştür. Bu rakam iş yükünün kendi belleğini içermez, bu nedenle 2 GB'ı taban, 4 GB'ı ise tek bir düğümün rahat çalıştığı ilk boyut olarak kabul edin. Kendi sunucunuzu, kurulumdan önce ve kube-system içindeki her pod Running durumuna geçtikten sonra free -h ile ölçün.
Aynı VPS üzerinde Docker ve k3s çalıştırabilir miyim?
Evet, ikisi birbirinden ayrı kalır. k3s kendi gömülü containerd'sini kullanır, bu nedenle docker build ile oluşturulan bir imaj, docker save myapp:0.1 | sudo k3s ctr images import - komutunu çalıştırana kadar k3s tarafından görülmez. Her biri ayrıca kendi iptables kurallarını ve kendi köprü ağlarını yazar. Toplam bellek kullanımını izleyin; çünkü Docker, k3s ve konteynerlerinizin tümü sunucunun RAM'ini paylaşır.
k3s'i tamamen nasıl kaldırırım?
Bir sunucu düğümünde sudo /usr/local/bin/k3s-uninstall.sh veya bir aracı düğümünde sudo /usr/local/bin/k3s-agent-uninstall.sh komutunu çalıştırın. Bu komut servisi durdurur, veri deposunu siler, /var/lib/rancher/k3s/storage altındaki kalıcı birim verilerini siler ve paketlenmiş araçları kaldırır. Saklamak istediğiniz tüm verileri önceden sunucudan kopyalayın, çünkü bu işlemin geri dönüşü yoktur. Geride kalan bir cni0 veya flannel.1 ağ arayüzü bir sonraki yeniden başlatmada kaybolacaktır.