Ubuntu K3s Üzerine Rancher Kurulumu: A'dan Z'ye Tam Rehber

Bu yazıda, Ubuntu sunucular üzerinde çalışan K3s (Lightweight Kubernetes) cluster'ınıza Rancher panelini nasıl kuracağınızı, kurulum sırasında karşılaşabileceğiniz "timeout" ve yazım hatalarını nasıl çözeceğinizi adım adım anlatıyorum.

1. Sistem Yapısı ve Hazırlık

Kurulumu yaptığımız Ubuntu yapısı şu şekildedir:

• OS: Ubuntu 24.04 LTS
• Cluster: 1 Master (10.10.10.13), 2 Worker (10.10.10.14-15)
• Donanım: Intel i7 İşlemci, 16GB RAM

2. Cert-Manager Kurulumu (Kritik Adım)

Rancher, SSL sertifikalarını yönetmek için cert-manager'a ihtiyaç duyar. Bu adım eksik olursa Rancher podları asla "Ready" konumuna geçmez.

# Helm repolarını ekleyin
sudo helm repo add jetstack https://charts.jetstack.io
sudo helm repo update

# Cert-manager kurulumu
sudo helm install cert-manager jetstack/cert-manager \
  --namespace cert-manager \
  --create-namespace \
  --set installCRDs=true \
  --kubeconfig /etc/rancher/k3s/k3s.yaml

3. Rancher Kurulumu ve Karşılaşılan Hatalar

Burada en sık yapılan hata, kurulumun hızlı biteceğini düşünmektir. Rancher, arka planda büyük "git" depolarını klonladığı için sabırlı olmalısınız.

💡 Çözülen Sorun 1: "Udo" Komutu Hatası
Terminalde sudo yazarken yanlışlıkla udo yazmak, sistemin alakasız paketler yüklemesine neden olabilir. Bu durumda CTRL + C ile işlemi durdurup sudo apt remove udo ile temizlik yapmalısınız.

# Rancher Stable reposunu ekleyin
sudo helm repo add rancher-stable https://releases.rancher.com/server-charts/stable
sudo helm repo update

# Dikey Kurulum Komutu (Performans Odaklı)
sudo helm upgrade --install rancher rancher-stable/rancher \
  --namespace cattle-system \
  --set hostname=rancher.local \
  --set bootstrapPassword=admin \
  --set replicas=1 \
  --create-namespace \
  --kubeconfig /etc/rancher/k3s/k3s.yaml \
  --wait --timeout 15m

4. Sorun Giderme: "Context Deadline Exceeded"

Eğer kurulum 15 dakikayı aşarsa Helm hata verebilir. Bu durumda podların durumunu kontrol etmek gerekir:

# Pod durumuna bakın
sudo kubectl get pods -n cattle-system --kubeconfig /etc/rancher/k3s/k3s.yaml

Eğer podlar 0/1 Running ise ve loglarda "Restoring git repositories" görüyorsanız, podları şu komutla tazeleyerek döngüden çıkarabilirsiniz:

sudo kubectl delete pod -l app=rancher -n cattle-system --kubeconfig /etc/rancher/k3s/k3s.yaml

5. Panele Erişim

Podlar 1/1 READY olduğunda, bilgisayarınızın hosts dosyasına şu satırı ekleyin:

10.10.10.13 rancher.local

Tarayıcıdan https://rancher.local adresine giderek belirlediğiniz şifre ile giriş yapabilirsiniz.

Sonuç: Artık tüm Kubernetes cluster'ınızı görsel bir panel üzerinden yönetmeye hazırsınız!